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CONVERSION  FACTORS,  NON-SI  TO  SI  (METRIC) 
UNITS  OF  MEASUREMENT 


Non- SI  units  of  measurement  used  in  this  report  can  be  converted  to  SI  (metric) 
units  as  follows : 


_ Multiply _ 

acres 

cubic  feet 

degrees  (angle) 

fathoms 

feet 

inches 

knots  (international) 

miles  (US  nautical) 

miles  (US  statute) 

pounds  (force)  per  square 
inch 


_ - 

4,046.873 

0.02831685 

0.01745329 

1.8288 

0.3048 

25.4 

0.5144444 

1.852 

1.609347 

6.894757 


_ T9  _ 

square  meters 

cubic  meters 

radians 

meters 

meters 

millimeters 

meters  per  second 

kilometers 

kilometers 

kilopascals 


COASTAL  MODELING  SYSTEM  fCMS'>  USF.R»S  MANUAL 


CHAPTER  1 

COASTAL  MODELING  SYSTEM  (CMS)  OVERVIEW 

PART  I :  INTRODUCTION 

Background 

1.  Numerical  modeling  technology  is  increasingly  being  employed  as  a 
tool  to  study  complex  problems  in  many  engineering  disciplines.  In  the  field 
of  coastal  engineering,  processes  studied  with  numerical  models  include: 
hydrodynamics  and  transport  associated  with  astronomical  tides,  storm  surges, 
and  tsunamis;  refraction,  diffraction,  shoaling  and  breaking  of  waves;  wave- 
induced  currents;  shoreline  change  induced  by  littoral  movement  of  sand; 
erosion  caused  by  short-term  severe  storms;  and  the  fate  and  stability  of 
dredged  material  placed  in  open  water. 

2.  Numerical  models  use  sophisticated  methodology  to  solve  governing 
equations  describing  the  physical  processes  of  interest.  When  a  physical 
process  is  well  described  by  the  specified  equations,  the  numerical  modeling 
technique  is  capable  of  providing  accurate  solutions  to  engineering  problems. 
However,  the  model  developer  must  take  extreme  care  in  implementing  the 
equations  in  a  numerical  scheme,  and  the  model  must  be  thoroughly  tested  for  a 
variety  of  conditions  and  compared  with  prototype  measurements  to  ensure 
correct  model  operation.  Of  equal  importance  is  the  care  the  engineer  must 
take  in  applying  the  model  to  a  field  problem  by  ensuring  that  the  model's 
governing  equations  are  appropriate  for  representing  the  dominant  physical 
processes  at  the  site.  Also,  errors  in  input  specification  could  dramatically 
alter  model  results,  and  without  diligent  inspection  of  model  output,  the 
errors  could  go  undetected. 

3.  The  Coastal  Engineering  Research  Center  (CERC)  has  developed  a 
number  of  numerical  models  that  are  used  for  studying  a  variety  of  coastal 
processes  under  existing  and  proposed  configurations.  Some  of  these  models 
are  large  and  complex  and  may  require  a  substantial  amount  of  input  data 
and/or  computing  effort.  The  models  usually  have  a  battery  of  supporting 
software  for  creating  computational  grids,  running  the  model  on  the  host 
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computer,  and  evaluating  large  amounts  of  output  from  the  simulations. 

Because  of  the  complexity  of  the  model  software  and  the  diversity  of 
modifications  to  input  data  associated  with  individual  applications,  these 
models  have  required  considerable  effort  to  apply. 

4.  Traditionally,  most  of  the  models  were  developed  by  researchers  as 
individual  efforts  to  solve  a  specific  problem.  Consequently,  models  have 
used  different  Input/output  structures,  have  been  sparsely  documented,  and 
have  been  frequently  altered  to  accomplish  application-specific  tasks.  In 
addition,  each  model  had  its  own  set  of  supporting  utilities  to  plot  results, 
reformat  data,  etc.  Often  code  alterations  resulted  in  several  versions  of 
the  same  model,  each  with  specific  or  enhanced  capabilities.  This  situation 
had  the  potential  for  introducing  errors,  either  by  engineers  applying  the 
wrong  version  of  the  model  or  by  programmers  Inadvertently  altering  the 
operation  of  a  previously  tested  portion  of  the  model. 

5.  Because  of  these  factors,  some  of  the  most  useful  models  at  CERC 
have  also  been  the  most  difficult  to  apply;  and  in  some  cases,  it  was  neces¬ 
sary  for  the  model  developer  to  oversee  the  specific  application.  This 
dependence  on  the  model  developer  meant  that  he  or  she  had  less  time  to  devote 
to  providing  improved  models  to  solve  Corps  problems. 

6.  The  condition  of  the  models  described  above  implied  a  need  for: 

£.  Maintenance  of  a  single  version  of  each  model. 

1^.  Standardization  of  the  model  input/output  processes. 

£.  A  central  location  for  using  the  models. 

Versatile  models  capable  of  covering  a  wide  range  of  problems 
at  different  sites  by  using  model  options. 

£.  Comprehensive  model  documentation  in  the  form  of  a  user's 
manual. 

Objective 

7.  The  Coastal  Modeling  System  (CMS)  is  a  software  package  aimed  at 
organizing  CERC's  larger  numerical  models  and  their  supporting  software  into  a 
user-friendly  system  that  is  available  to  all  Corps  elements  having  a  need  to 
apply  the  supported  modeling  technology. 

8.  Several  objectives  are  followed  in  developing  and  expanding  CMS. 
Since  some  of  the  models  share  similar  input  requirements,  output  capability. 
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and  procedural  implementation,  efforts  are  made  to  standardize  these  portions 
of  the  models  as  much  as  possible.  This  standardization  promotes  efficiency 
because  coding  effort  is  reduced,  new  users  learn  the  models  in  the  system 
more  rapidly,  and  chances  for  errors  in  entering  input  or  interpreting  output 
are  reduced  because  of  user  familiarity  with  the  system  structure. 

9.  Most  numerical  models  are  applied  to  specific  areas  by  representing 
the  spatial  bathymetric  and  topographic  features  as  depths  or  elevations  on  a 
matrix  called  a  computational  grid.  In  some  instances,  it  is  possible  to 
share  a  common  numerical  grid  between  models.  This  commonality  allows 
efficient  application  of  several  different  models  to  the  same  site  without 
additional  effort  in  building  new  grids.  Similarly,  processing  of  model 
output  data  can  proceed  in  the  same  manner  for  several  different  models.  To 
the  extent  possible,  models  in  CMS  share  the  same  nvimerical  grids,  utilities, 
plotting  programs,  post-processing  routines,  and  Job  control  files. 

10.  FORTRAN  77  programming  language  is  used  exclusively  in  the  system 
software  to  ensure  portability  of  the  models  and  supporting  programs  to  other 
computer  systems.  Graphics  programs  also  make  use  of  DISSPIA”  software.  When 
appropriate,  attempts  are  made  to  produce  a  code  that  is  capable  of  being 
vectorized  for  efficient  and  economical  use  on  vector  array  processing 
computers  such  as  the  CRAY  Y-MP,  where  CMS  resides. 

11.  Models  selected  for  Inclusion  in  CMS  must  be  well  advanced  in  their 
development,  and  they  must  have  been  rigorously  tested  over  a  wide  range  of 
conditions.  In  most  cases,  a  selected  model  has  already  been  applied  to 
numerous  field  problems  and,  thus,  has  reached  some  level  of  maturity  through 
careful  application  to  the  types  of  problems  encountered  by  the  Corps. 
Incorporation  of  these  time -tested  models  into  CMS  involves  modification  to 
the  input/output  structure  and,  possibly,  re-coding  of  sections  to  produce 
more  efficient  use  of  computer  resources.  Once  included  in  CMS,  the  models 
are  not  expected  to  be  modified  unless  errors  are  found  or  new  features  are 
added.  Therefore,  the  models  in  CMS  can  be  considered  tested,  reliable,  and 
mature . 
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PART  II:  IMPLEMENTATION  OF  CMS 


Organization 

12.  CMS  software  Is  organized  into  three  major  groups:  models, 

supporting  utilities,  and  procedure  files  that  draw  components  together  for 
execution.  Several  software  elements  use  common  algorithms,  and  efforts  are 
made  to  place  these  software  elements  into  shared  libraries.  This  placement 
eliminates  redundant  software  and  reduces  associated  development  costs. 

13.  Another  level  of  organization  concerns  user  interfaces  to  the 
software,  which  are  arranged  according  to  various  activities  encountered 
during  a  modeling  endeavor.  These  major  procedure  files  provide  users  access 
to  the  various  CMS  software  elements  on  the  available  computers. 

14.  Although  the  models  and  supporting  software  are  written  in  standard 
FORTRAN  77,  library  structures  and  procedure  files  are  specific  to  the 
computer  system  hosting  CMS.  In  addition,  some  plotting  utilities  rely  on 
specific  graphics  software  that  resides  on  the  host  computer,  and  certain 
terminal/plotter  configurations  may  be  required  to  produce  plots  of  the  model 
output  at  the  user's  local  site. 

Host  Computer  System 

15.  Most  models  Included  in  CMS,  or  targeted  for  addition  to  CMS,  are 
both  memory -Intensive  and  computationally  intensive,  requiring  use  of  large 
supercomputers  for  efficient  operation.  It  is  possible  to  run  some  of  the 
models  on  smaller  minicomputers,  but  double  precision  would  probably  be 
necessary  to  avoid  accumulated  round-off  errors,  and  applications  could  take 
from  several  hours  to  several  days  of  CPU  time  on  the  smaller  machines. 

16.  To  satisfy  the  objective  of  Corps -wide  access  to  the  models, 
initial  installation  of  CMS  was  on  a  mainframe  computer  operated  by  Scientific 
Information  Services  (SIS),  formerly  CYBERNET,  which  provided  Corps-wide 
mainframe  and  supercomputer  service.  Now,  with  the  installation  of  a  CRAY  Y- 
MP  at  the  US  Army  Engineer  Waterways  Experiment  Station  (WES),  Corps-wide 
access  is  available,  and  CMS  has  been  transferred  to  that  system  to  take 
advantage  of  reduced  costs  and  the  likelihood  of  a  permanent  home  for  CMS. 
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17 .  Corps  personnel  have  access  to  the  CRAY  Y-MP  through  several 
conununlcatlon  networks.  Presently,  the  supercomputer  can  be  accessed  through 
INTERNET,  MILNET,  ARPANET,  ASNET,  SURANET,  BITNET,  NSFNET,  through  a  1200, 

2400,  or  9600  baud  modem,  dedicated  line,  or  the  "front  end"  VAX  8800  comput¬ 
er. 

18.  Generally,  CMS  users  are  not  required  to  learn  the  operating  system 
associated  with  the  supercomputer  (UNICOS)  because  most  of  the  job  control 
commands  normally  required  to  submit  models  and  data  files  to  the  computer  for 
execution  are  accomplished  by  the  CMS  procedure  files.  This  setup  reduces 
learning  time  appreciably  and  minimizes  errors  caused  by  Improper  commands. 
However,  users  must  be  able  to  manipulate  files,  create  and  edit  ASCII  files, 
and  download  output  files  to  a  printer  or  plotter.  These  functions  are  easily 
mastered,  and  manuals  are  available  to  all  Corps  users  of  the  CRAY  Y-MP  at  a 
nominal  fee  by  contacting  the  Information  Technology  Laboratory  (ITL)  Research 
Library,  Ms.  Susan  Hicks  (601)  634-2296.  Presently  there  are  26  CRAY  manuals 
covering  such  topics  as  UNICOS  User  Commands,  CFT77  Reference,  UNICOS  Support 
Tools,  and  UNICOS  Symbolic  Debugging. 

Mo4?l  SJiPPVrt 

19.  Including  a  model  in  CMS  represents  a  technology  transfer  from  CERC 
to  the  field.  CERC  will  maintain  the  CMS  on  the  WES  CRAY  Y-MP  and  will 
provide  support  services  to  Corps  users  of  the  system.  Support  includes 
correcting  recognized  flaws  In  the  codes,  updating  the  models  with  new 
capabilities  and  technology,  Improving  the  user  Interface  to  the  models. 
Improving  graphics  and  visualization  capabilities,  updating  the  User’s  Manual 
to  reflect  changes  to  the  models  and/or  CMS,  conducting  periodic  workshops  for 
Corps  personnel,  and  providing  telephone  support  services. 

20.  Additionally,  CERC  staff  can  assist  Corps  personnel  In  applications 
of  the  CMS  via  "one-stop  services"  or  by  direct  participation  In  site-specific 
studies.  One-stop  service  Is  Intended  to  address  questions  or  problems  that 
arise  during  field  application  of  a  model  In  CMS.  Usually,  these  questions 
can  be  satisfactorily  resolved  In  a  short  time  over  the  telephone.  More 
involved  questions  requiring  a  substantial  effort  by  CERC  engineers  or 
scientists  may  require  reimbursement.  Experience  at  CERC  indicates  that  field 
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application  of  these  models  usually  requires  a  significant  initial  consulting 
effort  by  CERC  engineers  until  experience  has  been  gained  by  the  field  user. 

Coastal  Modelinf  System  (CHS)  User's  Manual 

21.  The  Coastal  Modeling  System  (CMS)  User's  Manual  is  intended  to  be 
an  evolving  document,  and  it  is  structured  in  a  modular  fashion,  much  like  the 
modeling  system  itself.  Individual  numerical  models  and  major  supporting 
utility  software  are  documented  in  separate  chapters.  Attempts  are  made  to 
structure  all  chapters  in  a  similar  format  to  facilitate  learning  the  system 
models. 

22.  The  unbound  format  of  the  user's  manual  allows  efficient  and  cost- 
effective  updating  of  the  manual  as  models  are  added  to  CMS,  and  it  allows 
users  to  remove  chapters  for  convenient  reference  during  model  applications. 
The  dociunentatlon  for  each  new  model  will  be  an  added  chapter  to  the  CMS 
User's  Manual.  Updates  will  also  Include  additions  of  (or  alterations  to) 
utilities  and  procedures. 

23.  Initial  distribution  of  the  CMS  User's  Manual  will  be  to  all  Corps 
Divisions  and  Districts  with  coastal  interests.  A  register  of  all  manuals 
distributed  within  the  Corps  of  Engineers  will  be  maintained  by  CERC,  and 
updates  will  be  provided  for  all  Corps-registered  copies  of  the  manual. 

24.  Training  on  the  usage  of  CMS  and  on  application  of  specific  models 
within  CMS  is  accomplished  during  periodic  workshops.  Workshop  participants, 
especially  new  users,  will  be  introduced  to  CMS.  Each  workshop  will  demon¬ 
strate  sign-on  procedures,  building  input  data  files,  file  transfer  methods, 
accessing  CMS,  running  workshop -specific  models,  and  post-processing  model 
results.  Technical  presentations  of  workshop  specific  models  will  also  be 
given.  More  intensive  training  can  be  provided  at  CERC  as  part  of  joint  field 
applications  between  CERC  and  personnel  from  a  field  activity. 

Point  of  Contact 

25.  Each  model  residing  in  CMS  has  a  CERC  point  of  contact  (POC) .  Most 
often  that  person  is  the  model  developer  or  someone  with  extensive  experience 
in  applying  the  model.  Table  1-1  provides  POC's  for  models  presently  included 
in  CMS.  This  table  will  be  updated  periodically  to  assure  that  it  continues 
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to  be  a  useful  reference  for  CHS  users.  The  modules  listed 
Table  1-1  are  briefly  described  in  Part  III  of  this  chapter 
ly  documented  in  later  chapters . 


Table  1-1 

CERC  Points  of  Contact 

Subject  Point  of  Contact  Office  Symbol 


CMS  general  Ms. 

inquiries 

Using  CMS  Ms. 

SPH  Mr. 

WIFM  Ms . 

RCPWAVE  Mr. 

CLHYD  Ms. 

SHALWV  Dr. 

STWAVE  Ms . 

HARBD  Dr. 

CMSGRID  Ms . 

CMSUTIL  Ms . 

CMSPOST  Ms . 


Mary  A.  Cialone 

CEWES-CR-P 

Lucy  W.  Chou 

CEWES-CR-P 

Dave  J.  Mark 

CEWES-CR-0 

Mary  A.  Cialone 

CEWES-CR-P 

Steven  M.  Bratos 

CEWES-CR-0 

Mary  A.  Cialone 

CEWES-CR-P 

Robert  E.  Jensen 

CEWES-CR 

Robin  D.  Relnhard 

CEWES-CR-0 

Edward  F.  Thompson 

CEWES-CR-0 

Mary  A.  Cialone 

CEWES-CR-P 

Lucy  W .  Chou 

CEWES-CR-P 

Lucy  W.  Chou 

CEWES-CR-P 

in  column  1  of 
and  are  extensive 


Phone  Number 

601-634-2139 

601-634-2843 

601-634-2094 

601-634-2139 

601-634-4230 

601-634-2139 

601-634-2101 

601-634-3492 

601-634-2027 

601-634-2139 

601-634-2843 

601-634-2843 


CMSSAMP 


Ms.  Lucy  W.  Chou 


CEWES-CR-P 


601-634-2843 


PART  III:  PRESENT  CMS  COMPONENTS 


26.  The  following  briefly  describes  the  numerical  models,  major  utility 
software,  and  major  procedures  currently  in  the  Coastal  Modeling  System. 


Chanter  2:  Using  the  Coastal  Modeling  System 


27.  This  chapter  provides  information  on  execution  of  the  CMS  on  the 
WES  CRAY  Y-MP.  The  new  user  should  refer  to  this  chapter  to  learn  to  compile 
or  run  a  model  for  a  specific  application.  Once  the  user  becomes  familiar 
with  the  system,  this  chapter  can  be  used  as  a  quick  reference. 


Chantei 


Standard  Project  Hurricane 


28.  The  numerical  model  SPH  is  a  parametric  model  for  representing  wind 
and  atmospheric  pressure  fields  generated  by  hurricanes.  It  is  based  on  the 
Standard  Project  Hurricane  criteria  developed  by  the  National  Oceanic  and 
Atmospheric  Administration  (NOAA  1979),  and  the  model's  primary  output  are 
hurricane -generated  wind  fields  that  can  be  used  in  storm  surge  modeling.  It 
can  be  run  separately,  or  it  can  be  invoked  from  within  the  WES  Implicit 
Flooding  Model  (WIFM) . 


29.  The  numerical  model  WIFM  solves  the  vertically  integrated  Navier- 
Stokes  equations  in  stretched  Cartesian  coordinates.  The  model  simulates 
shal low- water ,  long-wave  hydrodynamics  such  as  tidal  circulation,  storm 
surges,  and  tsunami  propagation.  WIFM  contains  may  useful  features  for 
studying  these  phenomena,  such  as  moving  boundaries  to  simulate  flooding/ 
drying  of  low-lying  areas  and  subgrid  flow  boundaries  to  simulate  small 
barrier  islands,  jetties,  dunes,  or  other  structural  features.  The  model  may 
be  driven  at  the  outer  boundary  by  tide  elevations,  flow  velocities,  specifi¬ 
cation  of  uniform  flux,  or  inverted  barometer  effects.  WIFM  also  accepts  wind 
fields  for  including  the  effects  of  wind  stress  during  hurricanes  or  other 
strong  storm  systems. 
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Chapter  5:  Regional  Coastal  Processes  Wave  Propagation  Model  (RCPWAVE) 

30.  The  numerical  model  RCPWAVE  is  a  short-wave  model  used  to  predict 
linear,  plane  wave  propagation  over  an  open  coast  region  of  arbitrary  bathyme¬ 
try.  RCPWAVE  uses  linear  wave  theory  because  it  has  been  shown  to  yield 
fairly  accurate  first-order  solutions  to  wave  propagation  problems  at  a 
relatively  low  cost.  Refractive  and  bottom- induced  diffractive  effects  are 
included  in  the  model;  however,  the  model  cannot  treat  diffraction  caused  by 
surface-piercing  structures.  This  model  does  not  include  nonlinear  wave 
effects  or  a  spectral  representation  of  irregular  waves. 

Chapter  6:  Curvilinear  Long-Wave  Hvdrodvnamic  Model  fClHYD) 

31.  The  numerical  model  CLHYD  simulates  shallow-water ,  long-wave 
hydrodynamics  such  as  tidal  circulation  and  storm  surge  propagation.  CLHYD 
can  simulate  flow  fields  induced  by  wind  fields,  river  inflows/outflows,  and 
tidal  forcing.  CLHYD  is  similar  to  WIFM,  with  the  added  feature  of  operating 
on  a  boundary- fitted  (curvilinear)  grid  system.  However,  CLHYD  cannot 
simulate  flooding/drying  of  low-lying  areas  as  WIFM  can.  This  feature  will  be 
incorporated  in  a  later  release  of  CLHYD. 

Chapter  7:  Spectral  Wave  Modeling  Module:  Model  SHALWV 

32.  The  numerical  model  SHALWV  is  a  time -dependent  spectral  wind-wave 
model  for  computing  a  time-history  of  wind- generated  waves.  The  model  solves 
the  inhomogeneous  energy  balance  equation  using  finite-difference  methods.  It 
simulates  the  growth,  decay,  and  transformation  of  a  wave  field  over  a  spatial 
area  (i.e.,  an  ocean  basin,  bay,  or  lake)  for  a  given  time  period.  SHALWV  can 
simulate  the  wave  climate  for  a  specific  storm  or  idealized  events,  such  as  a 
standard  project  hurricane. 

Chapter  8:  Spectral  Wave  Modeling  Module:  Model  STWAVE 

33.  The  numerical  model  STWAVE  is  a  near-coast,  time- independent 
spectral  wave  energy  propagation  model.  The  model  solves  the  spectral  energy 
balance  equation  (including  refraction,  shoaling,  and  wave  breaking)  using 
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finite-difference  methods.  This  steady-state  model  simulates  wave  propagation 
over  a  spatial  area  assuming  wave  conditions  vary  sufficiently  slowly.  The 
variation  of  waves  at  a  given  point  may  be  neglected  relative  to  the  time 
required  for  waves  to  pass  across  the  computational  grid  if  the  model  is 
limited  to  near-coast  applications  in  which  waves  move  quickly  across  the  grid 
(within  30  minutes). 

Chapter  9:  Harbor  Wave  Oscillation  Model  (HARBD) 

34.  The  nvunerlcal  model  HARBD  is  a  finite  element  model  for  predicting 
wave  oscillations  in  harbors.  HARBD  is  a  steady- state ,  linear  monochromatic 
wave  model  that  assumes  bathymetric  gradients  are  small  and  neglects  wave -wave 
interaction,  wave-current  interaction,  wave  breaking,  and  wave  transmission 
and  overtopping  of  structures.  The  model  has  been  used  in  the  design  and 
modification  of  numerous  harbors,  the  study  of  dredging  effects  on  wave 
propagation,  and  in  the  design  and  planning  of  wave  protection  structures  for 
existing  harbors. 

Appendix  A: _ CMSGRID 

35.  Grid  development  is  a  major  part  of  successfully  applying  a 
numerical  model  to  a  specific  site.  Module  CMSGRID  contains  software  used  in 
the  generation  of  stretched  coordinate,  rectilinear  computational  grids  for 
several  models  in  CMS .  The  software  employs  sophisticated  techniques  that 
allow  concentration  of  grid  cells  in  regions  of  interest,  or  where  geographic 
features  are  irregular,  and  wider  spacing  of  grid  cells  in  areas  where 
conditions  are  not  expected  to  change  rapidly.  The  ability  to  generate 
variably  spaced  grids  provides  economy  in  computational  time  and  costs. 
Generated  grids  can  be  plotted  to  scale  on  Mylar  for  overlaying  bathymetric 
charts  to  obtain  depths  and  elevations. 

Appendix  B:  CMSUTIL 

36.  Module  CMSUTIL  contains  useful  programs  that  supplement  numerical 
models  in  CMS .  Presently ,  there  are  two  programs  in  this  module :  a  program 
to  determine  tidal  constituents  from  a  time-history  of  tidal  elevations,  and  a 
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program  to  generate  a  time  series  of  water  elevations  from  tidal  constituent 
input . 


Appendix  G:  CMSPOST 

37.  Most  numerical  models  generate  large  output  files  containing 
results  saved  at  user-specified  grid  cells  and  time-steps  during  the  simula¬ 
tion.  Module  CMSPOST  contains  post-processing  plotting  packages  that  plot  the 
model  output  for  comparison  and  analysis  purposes.  Four  basic  types  of 
plotting  are  available;  (a)  time-histories  of  field  arrays  such  as  water 
surface  elevation  or  velocity  at  selected  grid  points,  (b)  "snapshots"  of  the 
entire  flow  field  at  a  given  instant  in  time,  (c)  wave  ray  plots,  and 
(d)  profile  plots  that  show  the  spatial  variation  of  a  model  variable  at  an 
instant  in  time. 


Appendix  P; _ CMSSAMP 

38.  Module  CMSSAMP  is  used  to  access  sample  input  files  for  each  of  the 
models  in  the  CMS .  This  provides  the  user  with  the  required  format  of  input 
data,  and  can  also  be  used  as  a  template  for  generating  the  user's  own  input 
flle(s).  In  addition,  sample  files  can  be  used  to  run  a  particular  model  in 
the  CMS  to  help  the  user  gain  familiarity  with  the  model.  Appendix  D  contains 
a  table  of  sample  input  file  names  and  the  procedure  for  accessing  these  files 
from  within  the  CMS. 
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CHAPTER  2 

USING  THE  COASTAL  MODELING  SYSTEM 

PART  1:  ACCESS  TO  THE  VAX  8800  AND  CRAY  Y-MP 


1.  The  Coastal  Modeling  System  (CMS)  is  available  to  all  Corps  elements 
through  the  CRAY  Y-MP  supercomputer  that  resides  at  the  Information  Technology 
Laboratory  (ITL),  U.S.  Army  Waterways  Experiments  Station  (WES).  This  chapter 
provides  a  detailed  description  of  the  steps  necessary  to  use  the  CMS.  In 
addition,  sample  runs  of  several  models  In  the  CMS  are  given  for  Illustration. 


2.  A  computer  account  for  both  the  VAX  8800  and  CRAY  Y-MP  can  be 
obtained  by  calling  the  Customer  Assistance  Center  (CAC)  at  WES  (601) 

634-4400.  Although  It  Is  no  longer  necessary  to  have  a  VAX  8800  account  to 
access  the  CRAY  Y-MP,  It  Is  recommended  that  the  user  obtain  a  VAX  6800 
account  for  data  manipulation  purposes.  Cost  for  usage  of  the  CRAY  Is  $500/hr 
(CPU  time)  and  $100/hr  (CPU  time)  for  the  VAX  8800.  Disk  storage  will  be 
billed  at  the  rate  of  $ 1.60/megaword- day  (1  megaword  -  8  megabytes)  on  both 
systems.  A  DA  448  -  Military  Interagency  Purchasing  Request  (MIPR)  or  a  DA 
2544  funding  document  must  be  sent  to  VES-CAC  before  computer  accounts  can  be 
set  up  on  the  CRAY  or  VAX. 


3.  A  user  can  log  onto  the  VAX  8800  through  the  INTEEtNET  network  or  a 
modem.  (INTERNET  Is  a  national  collection  of  networks  Including  MILNET, 
NSFNET,  ARPANET,  ASNET,  SURANET,  and  BITNET.)  The  login  procedure  Is  as 
follows : 

fl.  To  log  onto  the  ITL  VAX  8800  through  the  INTERNET  network, 
type  In  the  following  command  at  your  remote  workstation. 
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or 


ttlnet;  <K*t> 

where  134.164.4.1  is  the  INTERNET  address  for  the  ITL  VAX  8800. 
b.  To  log  onto  the  ITL  VAX  8800  through  a  1200  or  2400  modem: 

(1)  Dial  (601)  634-4458  or  FTS  542-4458  to  connect  to  the 
terminal  server. 

(2)  Press  the  RETURN  key  twice  after  the  terminal  server  is 
connected. 

(3)  Type  in  the  command: 

c  <r*t> 

A  9600  baud  modem  can  also  be  used.  The  telephone  number  for  the  9600  baud 
rate  is  (601)  634-4426  or  FTS  542-4426. 

4.  Once  connected  to  the  ITL  VAX  8800,  a  user  can  log  onto  the 
CRAY  Y-MP  from  the  VAX  8800.  The  user  can  also  connect  directly  to  the  CRAY 
Y-MP,  if  so  desired.  It  should  be  noted  that  the  UNICOS  operating  system  is 
case  sensitive;  therefore,  terminal  keyboard  CAPS  LOCK  should  remain  "off"  for 
all  CRAY  Y-MP  sessions. 

a.  To  log  onto  the  CRAY  Y-MP  through  the  VAX  8800,  type: 

b.  To  log  onto  the  CRAY  Y-MP  through  the  INTERNET  network,  type: 

Ittmty.MA.itniy.ttll  <e«t> 


or 


<r«t> 

where  134.164.8.2  is  the  INTERNET  address  of  the  WES  CRAY  Y-MP. 
£.  To  log  onto  the  CRAY  Y-MP  through  a  modem: 


2-2 


(1)  Dial  (601)  634-4458  or  FTS  542-4458  to  connect  to  the 
terminal  server. 

(2)  Press  the  RETURN  key  twice  after  the  terminal  server  is 
connected. 

(3)  Type  in  the  command: 

telnet  Urty 

The  computer  will  then  prompt  the  user  for  the  username  and  password  for 
his/her  account. 
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PART  II:  ACCESSING  THE  CMS 


5.  CMS  is  a  command  procedure  file  or  "shell  script"  for  using  models 
in  CMS.  The  script  serves  two  purposes:  (a)  it  builds  the  necessary 
preprocessor  file  and  compiled  source  code  of  the  desired  model,  and  (b)  It 
loads,  links,  and  executes  the  model.  The  steps  necessary  to  use  CMS  are  as 
follows : 

a.  To  access  CMS,  type  In  the  command: 


Note  that  CMS  resides  on  the  CRAY  Y-MP  account  /u3/h2crplc0 ; 
therefore,  the  user  must  provide  this  path  name  when  accessing 
CMS.  The  computer  will  then  prompt  the  user  with  a  series  of 
questions.  In  menu  form,  concerning: 

(1)  The  desired  model  name. 

(2)  The  model  procedure  name,  which  Is  either  BUILD  (or  build), 
RUN  (or  run) ,  or  EXIT  (or  exit)  where  "build"  is  used  for 
compiling  and  linking  the  model,  "run"  is  used  for  model 
execution,  and  "exit"  is  used  to  terminate  the  CMS  session. 

(3)  The  Input  and  output  filenames.  Filenames  should  be 
limited  to  8  digits  with  3 -digit  extensions  If  they  are  to 
be  transferred  to  a  personal  computer  (PC) .  It  Is 
recommended  that  Input  files  be  created  and  edited  on  the 
VAX  8800  or  on  the  user's  PC  and  transferred  to  the  CRAY  Y- 
MP  for  CMS  simulations. 

Following  the  entry  of  all  output  filenames,  CMS  launches  a 
batch  job  to  the  CRAY  Y-MP,  for  example: 


where  1234  is  the  job  number  assigned  by  the  CRAY  Y-MP  for  the 
particular  run.  The  batch  queue  selected  by  the  system.  In  this 
case  "prime,"  Is  based  on  the  estimated  execution  time  of  the 
job. 

1^.  To  check  the  job  status  after  It  Is  submitted  to  the  CRAY  Y-MP, 
the  user  can  type  In  the  UNICOS  command: 


where  -a  Indicates  status  of  the  current  user's  batch  jobs  only. 
If  the  batch  job  Is  still  In  the  batch  queue,  the  computer  will 
respond: 
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1234. larry  wl fm^build . coa  h2crpac0  pr laeaflarry 
no  pipe  queue  entries 
no  device  queue  entries 


indicating  that  the  job  is  still  in  the  batch  queue.  If  the  job 
is  completed  (compiled  or  executed) ,  the  conq>uter  will  respond: 


no  batch  queue  entrtda 
no  pipe  queue  entries 
no  device  queue  entries 


6.  To  save  computing  time  and  expenses,  CMS  is  divided  into  two  parts: 
(a)  compilation  and  (b)  execution.  The  user  can  change  certain  values  in  the 
input  data  set  without  recompiling  the  model.  However,  changing  certain 
crucial  values  will  require  recompilation.  After  the  job's  completion,  system 
output  files  will  be  generated  and  will  reside  in  the  user's  working 
directory.  The  two  files  generated  after  model  compilation  are  named 
Model_bu.exzxz  and  Nodel_bu.oxxxz,  and  the  two  system  output  files  generated 
after  model  execution  are  Model_ru.exxzx  and  llodel_ru.ox3QCS.  The  zxzx  is  the 
4  or  5-diglt  job  number  assigned  by  the  system  (depending  on  the  CRAY  Y-MP 
schedule)  for  the  particular  run.  The  .e  file  contains  compiling  or  execution 
error  messages  while  the  .o  file  contains  a  sunoiary  report  of  the  job 
accounting  information.  Example  filenames  are  given  in  Table  2-1. 

Table  2-1 
Example  Filenames 


Example  Procedure  Example  File  Produced 

Build  UIFM  UIFM_BU.E1234 

WIFM_BU.01234 

Run  WIFM  HIFM_RU.E5678 

Vim  RU. 05678 
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7.  To  read  the  error  messages  or  the  accounting  report,  the  user  can 
type  the  UNICOS  command 


pg.  fltmjUKm  <r«t£>! 

where  "file_name"  is  a  filename  in  the  form  mentioned  previously  and  in  Table 
2-1.  The  pg  command  displays  the  text  file  on  a  terminal,  one  screenful  at  a 
time .  The  user  can  press  the  return  key  to  view  another  screenful  or  p  to 
terminate  viewing  of  the  particular  file.  The  UNICOS  command  cat  is  not 
recommended  for  this  purpose  because  the  entire  file  will  scroll  onto  the 
terminal  screen  and  it  is  difficult  to  terminate  the  scrolling  process. 
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PART  III:  ILLUSTRATIONS  OF  THE  CMS 


Compilation 

8.  For  Illustrative  purposes,  model  WIFM  was  selected  for  compilation. 
Compilation  of  any  of  the  other  models  In  the  CMS  Is  Identical  to  the 
procedure  given  below.  The  user: 

a.  Invokes  CMS. 

b.  Selects  the  name  of  the  desired  model. 

£.  Selects  "BUILD"  to  compile  and  link  the  desired  model. 

Enters  the  Input  filename  to  be  used  for  the  subsequent  model 
run. 

9.  CMS  resides  on  the  CRAY  Y-MP  account  /u3/h2crplc0 ;  therefore,  the 
user  must  provide  this  path  name  when  accessing  CMS.  To  compile  model  VIEN, 
the  user  (h2crplcl  for  the  following  examples)  Invokes  CMS  by  entering  the 
Information  shaded  below  (step  s) .  It  should  be  noted  that  user  entries  are 
shown  as  shaded  and  CMS  response  "screens”  are  shaded  boxes.  The  Information 
preceding  the  shaded  command  In  step  a  (h2crplcl:larr7$)  is  a  system  prompt. 

fl.  h2crplcl:larry9/S^/liK^^^ 

The  CMS  responds: 


WE  L  C  0  M  E 

TO., 

XXXXX 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

XXXXX 

Return  for 

more., . 
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* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


CMS  COMPONENTS 

r***********************^ 

Options; 

CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  - >  1 

CMSMODEL  (Compiles,  links,  loads,  and  executes 

numerical  models)  - - >  2 

CMSPOST  (Plots  and  lists  model  outputs)  - - >  3 

CMSUTIL  (Additional  "utility"  programs)  - - - >  4 

CMSSAMP  (Sample  input  files  for  each  model)  . . >  5 

Exit  CMS  . . . . . - . - . >  q 


* 

* 

•k 

* 

* 

* 

* 

* 

* 

k 

k 

k 

k 

k 


Enter  option  number  . . >  H 

The  CMS  responds: 


ccccc 

M 

M 

SSSSS 

M 

M 

00 

DDDDD 

EEEEE 

L 

c 

MM 

MM 

s 

MM 

MM 

0 

0 

D 

D 

E 

L 

c 

M  M  M  M 

s 

M  M  M  M 

0 

0 

D 

D 

E 

L 

c 

M  M  M 

ssss 

M  M  M 

0 

0 

D 

D 

EEE 

L 

c 

M 

M 

s 

M 

M 

0 

0 

D 

D 

E 

L 

c 

M 

M 

s 

M 

M 

0 

0 

D 

D 

£ 

L 

ccccc 

M 

M 

SSSSS 

M 

M 

00 

DDDDD 

EEEEE 

LLLLL 

Return  for  more.  .  . 


USING  THE  COASTAL  MODELING  SYSTEM 


*  Options: 

* 

*  On-Line  Help  - 

* 

*  Enter  CMSMODEL  Module 


->  2 


*  Return  to  Main  Menu  - - - -  —  - 3 

* 


Enter  option  nuunber 
The  CHS  responds: 


Models  Presently  in  Syston 


CLHYD: 

Curvilinear  Hydrodynamic  2-Dlmenslonal  Model 

HARBD: 

Harbor  Wave  Oscillation  Model 

RCPWAVE: 

Regional  Coastal  Processeis  Wave  Model 

SPH: 

Standard  Project  Hurricane  Wind  Mbdel 

SWM: 

SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

WIFM: 

WES  Implicit  Flooding  Model 

EXIT: 

Terminate  computer  session 

The  user  is  prompted  to  enter  the  name  of  the  model  desired: 
1;^.  Enter  name  of  model 


The  CMS  responds: 


Select  Model  Procedure: 

BUILD  -  compile  and  link  model 

RUN  -  execute  model 

EXIT  •  terminate  computer  session 


For  this  example  WIFM  is  compiled  and  linked  by  responding  to  the  CMS  prompt 
with: 


c.  Enter  procedure  name 

The  user  is  prompted  for  the  input  data  set  as  follows: 
i.  Enter  name  of  input  data  file 

Note  that  the  name  of  the  user's  input  data  file  (/wifm/test/mock. inpl)  may  be 
different  from  that  given  in  step  The  system  responds: 


Request  2710.1arry  sxibmitted  to  queue:  prime. 
END  OF  CMS  PROCEDURE 
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This  procedure  launches  a  batch  Job  (number  2710)  to  the  CRAY  Y-MP.  The  user 
then  has  the  option  of  continuing  to  use  the  CMS  or  exiting  from  the  0(S: 


e. 


Do  you  want  to  continue  the  computer  session  ? 
Enter  y[es]  or  [n]o  to  continue  § 


The  system  responds  with  the  Interactive  job  accounting  summary  as  follows: 


Job  Accounting  -  Summary  Report 

' 

Job  Accounting  File  Marne 

/tmp/J  tmp . 001818a/.  J  acctlSlS 

Operating  System 

snl022  larry  6.1  gar. 28  CRAY  Y-MP 

User  Name  (ID) 

h2crplcl  (1432) 

Group  Name  (ID) 

CERC  (105) 

Account  Name  (ID) 

A-cerc  (200) 

Job  Name  (ID) 

1818 

Report  Starts 

06/15/92  10:35:47 

Report  Ends 

06/15/92  10:36:33 

Elapsed  Time 

46  Seconds 

User  CPU  Time 

0.3736  Seconds 

System  CPU  Time 

0.1831  Seconds 

I/O  Wait  Time  (Locked) 

0.2748  Seconds 

I/O  Wait  Time  (Unlocked) 

0.4207  Seconds 

CPU  Time  Memory  Integral 

0.0318  Mword- seconds 

SDS  Time  Memory  Integral 

0.0000  Mword- seconds 

I/O  Walt  Time  Memory  Integral 

0.0110  Mword- seconds 

Data  Transferred 

0.0762  Hwords 

Logical  I/O  Requests 

244 

Physical  I/O  Requests 

121 

Nximber  of  Commands 

11 

Biillng  Units 

0.0000 

Interactive  CPU  costs  are  the  sum  of  'User  CPU  Time'  and  'System  CPU  Time' 
listed  above,  multiplied  by  the  CPU  cost  per  hour  (see  Part  I).  For  this 
example,  the  Interactive  costs  were  .5567  sec  multlpled  by  $500/hr  or  7.7 
cents . 

10.  To  check  the  status  of  the  batch  Job,  the  user  types: 
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When  the  system  responds: 


no  batch  queue  entries 
no  pipe  queue  entries 
no  device  queue  entries 


then  the  batch  Job  Is  completed. 

11.  To  check  the  status  of  files  produced  by  the  batch  Job,  the  user 
types  the  following  to  check  the  status  of  the  error  file: 

h2crplcl:larry$  Is 

-rw -  1  h2crplcl  CERC  0  Aug  13  12:54  wlfn_bu.e2710 


and  the  following  to  check  the  status  of  the  output  files: 


h2crplcl ;  larry$ 

-rw -  1  h2ci^icl  "CKC 

-rw -  1  h2crplcl  CERC 


1556  Aug  13  12:54  wlfn_bu.o2710 
450504  Aug  13  12:54  wlfmall.o 


The  .e2710  file  contains  compiling  error  messages,  and  the  .o2710  file 
contains  a  summary  report  of  the  Job  accounting  Information.  Similar  to  the 
Interactive  CPU  costs,  batch  Job  CPU  costs  are  given  In  the  summary  report  as 
the  sum  of  'User  CPU  Time'  and  'System  CPU  Time,'  multiplied  by  the  CPU  cost 
per  hour. 

12.  To  view  the  compiling  error  message,  the  viser  types: 


h2crplcl : larry^ 


In  this  case,  there  are  no  error  messages.  If  the  user  encounters  compilation 
errors,  he  or  she  should  call  the  Coastal  Engineering  Research  Center  (CERC) 
CHS  representative. 

13.  To  view  the  summary  report  of  the  Job  accounting  Information,  the 
user  types: 


h2crplcl : larry6 


The  system  responds: 
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USAEWES  Information  Technolo^  Laboratory 

CRAY  Y-MP  8/6128  (UMipOS  5.1)  ^  ^ 

Questions/problems/comments  - 

>  call  Customer  Assistance  at 

(601)634-4400  or  send  mail  to 

cag!@wesim3 

%%  Use  'bull'  for  information 

on  tapes,  printer,  and  other  news.  %% 

Job  Accounting  -  Summary  Report 

Job  Accounting  File  Name 

;  /tmp/nqs .-t-H-f+O+eL/. jacctll66 

Operating  System 

:  snl022  tarry  5.1  1022.15  CRAY  Y-MP 

User  Name  (ID) 

;  h2crplcl  (1458) 

Group  Name  (ID) 

:  CERC  (105) 

Account  Name  (ID) 

:  A-00000  (0) 

Job  Name  (ID) 

:  wifa^>ulid. com  (1166) 

Report  Starts 

t  08/13/90  12:53:20 

Report  Ends 

:  08AV90  12:54:02 

Elapsed  Time 

:  42  Seconds 

User  CPU  Time 

:  36.2225  Seconds 

System  CPU  Time 

:  0.8803  Seconds 

I/O  Walt  Time  (Locked) 

:  0.1809  Seconds 

I/O  Wait  Time  (Unlocked) 

0.6861  Seconds 

CPU  Time  Memory  Integral 

:  35.9472  Mword-seconds 

SDS  Time  Memory  Integral 

:  0.0000  Hwotd-seconds 

I/O  Wait  Time  Memory  Integral 

:  0.2086  Mword-seconds 

Data  Transferred 

:  2.1089  Mbytes 

Logical  I/O  Requests 

:  518 

Physical  I/O  Requests 

:  454 

Ntmiber  of  Commands 

:  16 

Billing  Units 

:  0.0000 

In  this  example,  the  cost  of  running  a  batch  Job  to  compile  model  UIFN  was 
37.1028  sec  multlpled  by  $500/hr  or  $5.15. 

Execution 

14.  Models  WIFM,  SPH,  RCFWAVE,  and  CLHYD  were  selected  for  execution. 
The  user  Is  referred  to  Chapters  7  and  above  for  Illustrations  of  other  models 
in  the  CMS.  To  execute  model  tfIFM,  the  user  types: 
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The  CMS  responds: 

WELCOME 

TO.. 

• 

XXXXX  X 

X 

XXXXX 

XX  XX 

XX 

X  X 

X  X  X  X  X 

X 

X  XX 

X 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

X 

XXXXX 

Return  for 

more . . . 
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iririrTrwicwxTriwrTrirwXw?r7rWTrx7rirTflotiir«r7rir#iiririiriirif7«XwiiTrTr^ 

*  CMS  COMPONENTS  * 

ii'kitil'ktli'kit^citieiciricieititic'kirk'k'k'kicic'kicii'ii'iritie'klc'ic'iHeic'kirkie'tcItitli'it-k'k'kitiiit'k-kieie-k'kfrkieirkitleie 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  niunerical  grid)  . >  1* 


*  CMSGRID  (Maps,  plots,  and  lists  the  niunerical  grid) 

* 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes 


numerical  models) 


*  CMSPOST  (Plots  and  lists  model  outputs) 

*  CMSDTIL  (Additional  "utility"  programs) 

*  ■■ 

*  CHSSAMP( Sample  input  files  for  each  model) 

*  Exit  CMS  ------ . . 


* 

* 

->  2  * 
* 

->  3  * 

* 

->  4  * 
★ 

->  5  * 
* 

->  q  * 


Enter  option  number 


The  CMS  responds: 
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Return  for  more.  .  . 


* 

* 

* 

* 


Options : 

On* Line  Help 


•>  1 


★ 

* 

* 


* 

it 

Entpr  CMSMODFL  Module 

V'" 

it 

* 

.  ■'* 

\  1* 

* 

* 

Enter  option  number 


> 


i 


The  CMS  responds: 


r  r  r  r*  r  ir* 


Models  Presently  in  System 


Curvilinear  Hydrodynamic  2 -Dimensional  Model 


CLHYD 


Harbor  Wave  Oscillation  Model 


HARBD 


RCPWAVE:  Regional  Coastal  Processes  Wave  Model 


Standard  Project  Hurricane  Wind  Model 


SPECTRAL  WAVE  MODELING 

SHALWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 


WES  Implicit  Flooding  Model 


WIFM 


The  user  is  prompted  to  enter  the  name  of  the  model  desired 


Enter  name  of  model 


The  CMS  responds 


Return  for  more 


Selddt  Model  Procedure 


BUILD 

RUN 

EXIT 


compile  and  link  model 
execute  model 

terminate  computer  session 


For  this  example  UIFM  is  executed  by  responding  to  the  CMS  prompt  with: 


£• 


Enter  procedure  name 


The  user  is  prompted  for  the  input  and  output  data  sets  as  follows.  Note  that 
the  names  of  the  user's  input  and  output  files  may  differ  from  those  given  in 
steps  ji,  £,  g,  and  h-  Example  input  and  output  files  can  be  found  in 
Chapter  4  (UIFM)  or  accessed  on-line  using  CMSSAMP  (see  Appendix  D) . 

A  hotstart  simulation  Indicates  that  model  results  (water  surface  elevations 
and  velocities)  have  been  saved  from  a  previous  simulation  and  are  to  be  used 
as  Initial  conditions  for  the  present  simulation: 


&■ 

Is  this  a  HOTSTART  simulation? 

Enter  y[es]  or  n[o]  to  continue  |[ 

£• 

Enter  the  name  of  the  output  data  file  ^ 

outdeck  -  mock. out 

Hydrograph  data  are  time-histories  of  model  results  (l.e.,  water  surface 
elevations  and  velocities)  at  selected  (gage)  points  in  the  computational 
domain. 

g.  Do  you  want  to  save  hydrographic  data? 

Enter  y[es]  or  n[o]  to  continue  | 

Enter  the  name  of  the  hydrograph  data  file 

A  snapshot  is  a  "picture”  of  the  flow  field  for  the  entire  grid  or  a  portion 

of  the  grid  at  a  given  instant  in  time. 

b.  Do  you  want  to  save  snapshots? 

Enter  y[es]  or  n[o]  to  continue  ^ 

Enter  the  name  of  the  snapshot  data  file 

Hotstart  data  (water  surface  elevations  and  velocities)  can  be  saved  for  the 

entire  computational  domain  for  use  in  a  subsequent  simulation. 

JL.  Do  you  want  to  save  hotstart  data? 

Enter  y[es]  or  n[o]  to  continue  ^ 

The  system  responds: 


Request  2713. larry  Submitted  to  queue:  prlise. 
****  END  OF  CMS  PROClDtfRR 


This  procedure  launches  a  batch  Job  (number  2713)  to  the  CRAY  Y-MP.  The  user 
then  has  the  option  of  continuing  to  use  the  CMS  or  exiting  from  the  CMS: 
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£.  Do  you  want  to  continue  the  computer  session  ? 

Enter  y[es]  or  [n]o  to  continue 

The  system  responds  with  the  Interactive  job  accounting  summary  as  follows: 


Job  Accounting  -  Summary  Report 

Job  Accounting  File  Name 

/tmp/j tmp . 001818a/ . j acctlSlS 

Operating  System 

snl022  larry  6,1  gar. 28  CRAY  Y-MP 

User  Name  (ID) 

h2crplcl  (1432) 

Group  Name  (ID) 

CERC  (105) 

Account  Name  (iD) 

A-cerc  (200) 

Job  Name  (ID) 

1818 

Report  Starts 

06  A5/92  10:35:47 

Report  Ends 

06/15/92  10:36:33 

Elapsed  Time 

46  Seconds 

User  CPU  Time 

0.3736  Seconds 

System  CPU  Time 

0.1831  Seconds 

I/O  Wait  Time  (Locked) 

0,2748  Seconds 

I/O  Wait  Time  (Unlocked) 

0.4207  Seconds 

CPU  Time  Memory  Integral 

0.0318  Mword- seconds 

SDS  Time  Memory  Integral 

0.0000  Mword- seconds 

I/O  Wait  Time  Memory  Integral 

0.0110  Mword-seconds 

Data  Trans ferted 

0.0762  Mwords 

Logical  I/O  Requests 

244 

Physical  I/O  Requests 

121 

Ntifflber  of  Cotmnands 

^'''"■;.;il" 

Billing.-Units?;.  ■ ,  , 

0.0000 

15.  In  order  to  check  the  status  of  the  batch  job,  the  user  types: 

h2crplcl :  larr7$ 

If  the  job  Is  still  In  the  batch  queue,  the  computer  responds: 

:2713.1arry  wlfm_ruh.com  h2crpmcO  prlme@lhrry 
tio  pipe  queues  entrlei 
no  deviee  queue  entries 


When  the  system  responds: 


no  batch  queue  entries 
no  pipe  qtieue  entries 
no  device  queue  entries 


then  the  batch  job  Is  completed. 


16.  To  check  the  status  of  files  produced  by  the  batch  job,  the  user 


t3T)es : 


h2crplcl:larry$ 


-rw -  1  h2crplcl  CERC 

-rw -  1  h2crplcl  CERC 


and 


0  Aug  13  12:54  vlfaL.ba.e27 10 
73  Aug  13  13:01  vlfiL.ra.e2713 


h2crp.cl:larry3 

-rv -  1  h2crplci  CERC 

-rv -  1  h2crplcl  CERC 

-rv -  1  h2crplcl  CERC 

-rv -  1  h2crplcl  CERC 

-rv -  1  h2crplcl  CERC 


140567  Aug 
0  Aug 
1556  Aug 
1554  Aug 
450504  Aug 


13  13:01  aK>ck.ottt 
13  13:01  vlfB.out 
13  12:54  vlfB_ba.o2710 
13  13:01  vlfm_ra.o2713 
13  12:54  vifMll.o 


The  .e  file  contains  compiling  error  messages,  and  the  .o  file  contains  a 
summary  report  of  the  Job  acco\mtlng  Information. 

17.  To  view  the  system  error  messages,  the  user  types: 


h2crplcl :  larry$  pgt'arl 


The  system  responds: 


STOP 

CP:  7.886s,  Wallclock:  7.987s,  16.5%  of  6-CPU  Machine 


In  this  case,  there  are  no  error  messages.  Types  of  errors  one  ml^t 
encounter  Include: 


Floating  exception 

TBOOl  -  BEGINNINC  OP  TRACEBACK 

-  $TRBK  WAS  CALLED  BY  f  slg 

AT  234471a  (LINE  NUMBER 

235) 

-  f  slg  WAS  CALLED  BY  CALLFUHC  AT 

204414c 

^  CALLFUNC  WAS  CALLED  BY  WIFIOCY 

AT 

31402a 

-  WIFMXY  WAS  CALLED  BY  WIFM 

AT 

664c  (LINE  NUMBER 

236) 

-  WIFM  WAS  CALLED  BY  $StART$ 

AT 

136d 

TB002  -  END  OF  TRACEBACK 
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which  indicates  that  a  "floating  divide  by  zero"  or  a  dimensioning  problem  was 
encountered  during  the  simulation.  If  this  occurs,  call  the  CERC  CMS 
representative.  Input  errors  would  not  be  indicated  in  the  system  error  file 
(wifm_ru.e2713) ,  but  can  be  found  in  the  model  output  file  (mock. out).  A 
sample  output  file  with  errors  should  be  examined  as  shown  in  Table  2-2.  The 
underlined  Information  in  Table  2-2  is  typed  by  the  user,  making  use  of  the 
CRAY  line  editor  (see  UNICOS  primer  SG-2010  C). 


Table  2-2 

Example  of  an  Input  Error 


ed  mock. out 

^  to  go  to  the  end  of  the  file 

*****  program  aborting  i ! ! ! ! 

Q  to  determine  the  line  number  at  the  end  of  file 

242  *****  PROGRAM  ABORTING  ! !! ! ! 

230. $p  to  type  lines  230  to  the  end  of  file 

***  FATAL  ERRORS  -  2  WARNINGS  -  0 

*****  SYSTEM  SPECIFICATION  --  "FNGLISH  "  NOT  RECOGNIZED  !!!!! 

*****  program  aborting  ! ! ! ! ! 


18.  To  view  the  summary  report  of  the  Job  accounting  information,  the 
user  types: 

hZcrplcl :  larry8  ^ 

The  system  responds: 
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USAEWES  Information  Technology  Laboratory 
CRAY  Y-MP  8/6128  (UNICOS  5.1) 

Questions/problems/comments  -->  call  Customer  Assistance  at 
(601)634-4400  or  send  mail  to  cag@wesim3 

%%  Use  'bull'  for  Information  on  tapes,  printer,  and  other  news,  tt 


Job  Accounting  -  SunuBary  Report 


Job  Accoiinting  File  Name 
Operating  System 
User  Name  (ID) 

Group  Name  (ID) 

Account  Name  (ID) 

Job  Name  (ID) 

Report  Starts 

Report  Ends 

Elapsed  Time 

User  CPU  Time 

System  CPU  Time 

I/O  Wait  Time  (Locked) 

I/O  Wait  Time  (Unlocked) 

CPU  Time  Memory  Integral 
SDS  Time  Memory  Integral 
1/0  Wait  Time  Memory  Integral 
Data  Transferred 
Logical  I/O  Requests 
Physical  I/O  Requests 
Nvifflber  of  Commands 
Billing  Units 


/tmp/nqs . +++++0+e0/ . j  acct 1181 
snl022  larry  5.1  1022.15  CRAY  Y-MP 
h2crplcl  (1458) 

CERC  (105) 

A-00000  (0) 
wifm  run.com  (1181) 

08/13/90  13:01:40 
08/13/90  13:01:51 

11  Seconds 

8.3513  Seconds 
0.1963  Seconds 
1.3230  Seconds 
1.0556  Seconds 
2.8742  Mword-seconds 
0.0000  Mword-seconds 
0.3517  Mword-seconds 
4.5823  Mbytes 
189 
260 
11 

0.0000 


19.  To  execute  model  SPH,  the  user  types: 


&■ 


h2crplcl : larry $ 


The  CMS  responds: 
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CMS  COMPONENTS 


*  Options 


*  CMSGRID  (Maps ^plots^  and  lists  the  numerical  grid) 


*  CMSMODEL  (Compiles,  links,  loads,  and  executes 

*  htimer leal  models)  - . . 


*  CMSPOST  (Plots  and  lists  modeT  outputs) 


*  CMSUTIL  (Additional  "utility"  programs) 


*  CMSSAMP  (Sample  input  files  for  each  model) 


Enter  option  number  . . >  1 


The  CMS  responds: 
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CCCCC  H  M  SSSSS  M  H  00  DDDDD  BEEEE 
MM  NM  S  MM  MM  0  0  D  D  E 

MMMMS  MMMMO  0  D  DE 

M  M  M  SSSS  M  M  M  0  0  D  D  EEE 


CCCCC  M 


DDDDD  EEEEE  LLLLL 


Return  for  more 


USING  THE  COASTAL  MODELING  SYSTEM 


*  Options 


Enter  CNSMODEL  Module 


Return  to  Main  Menu 


Enter  option  number  . . >  ^ 


The  CMS  responds: 
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>4  >4  >4  >4  >4  i4 


* 

Models  Presently  in  System  * 

CLHYD: 

Curvilinear  Hydrodynamic  2-DiiMnslonal  Model 

HARBD: 

Harbor  Wave  Oscillation  Model 

RCPWAVE: 

Regional  Coastal  Processes  Wave  Model 

SPH: 

Standard  Project  Hurricane  Vind  Model 

SVM: 

SPECTRAL  WAVE  MODELING 

SHALVV:  Time  Dependent  Wave  Model 

STUAVE:  Time  Independent  Wave  Model 

WIFM: 

WES  Implicit  Flooding  Model 

EXIT: 

Terminate  computer  session 

SSSSS 

PPPPP 

H  H 

S  S 

P  P 

H  H 

S 

P  P 

H  H 

SSSSS 

PPPPP 

HHHHHHH 

S 

P 

H  H 

S  S 

P 

H  H 

SSSSS 

P 

H  H 

Return 

for  more . 

Select  Model  Procedure: 

BUILD  -  compile  end  link  model 

RUM  -  execute  model 

EXIT  *  terminate  computer  sees Ion 


For  this  example  SPH  is  executed  by  responding  to  the  CMS  prompt  with: 

£.  Enter  procedure  name 

The  user  is  prompted  for  the  input  and  output  data  sets  as  follows.  Note  that 
the  names  of  the  users  input  and  output  files  may  differ  from  those  given  In 
steps  4i  £i  and  Example  input  and  output  files  can  be  found  In  Chapter  3 
(SPH)  or  accessed  on-line  using  CMSSAMP  (see  Appendix  D) . 

d-  Enter  the  name  of  the  Input  data  file 


£.  Enter  the  name  of  the  output  data  file 

Hydrograph  data  are  time -histories  of  model  results  (l.e.,  wind  velocities)  at 
selected  (gage)  points  In  the  computational  domain. 

£.  Do  you  want  to  save  hydrographic  data? 

Enter  y[es]  or  n[o]  to  continue  i 

Enter  the  name  of  the  hydrograph  data  file 

A  snapshot  Is  a  "picture"  of  the  flow  field  for  the  entire  grid  or  a  portion 

of  the  grid  at  a  given  Instant  In  time. 

£.  Do  you  want  to  save  snapshots! 

Enter  y[es]  or  n[o]  to  continue  ^ 

The  system  responds: 


Request  8640.1arry  subfitted  to  queue:  prime. 

****  end  of  CMS  PROCEDURE 


This  procedure  launches  a  batch  Job  (number  8640)  to  the  CRAY  Y-MP.  The  user 
then  has  the  option  of  continuing  to  \ise  the  CMS  or  exiting  from  the  CMS: 

h.  Do  you  want  to  continue  the  computer  session  ? 

Enter  y[es]  or  [n]o  to  continue  § 
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The  system  responds  with  the  Interactive  Job  accounting  summary  as  follows 


Job  Accounting  •  Svunmary  Report 


Job  Accounting  File  Name 
Operating  System 
User  Name  (ID) 

Group  Name  (ID) 

Account  Name  (ID) 

Job  Name  (ID) 

Report  Starts 
Report  Ends 
Elapsed  Time 
User  CPU  Time 
System  CPU  Time 
I/O  Wait  Time  (Locked) 

I/O  Wait  Time  (Unlocked) 

CPU  Time  Memory  Integral 
SDS  Time  Memory  Integral 
I/O  Wait  Time  Memory  Integral 
Data  Transferred 
Logical  I/O  Requests 
Physical  I/O  Requests 
Niunber  of  Commands 
Billing  Units 


/tmp/j  tmp . 001818a/ . jacctl818 
snl022  larry  6.1  gar. 28  CRAY  Y-MP 
h2crplcl  (1432) 

CERC  (105) 

A-cerc  (200) 

1818 

06/15/9210:35:47 
06/15/92  10:36:33 

46  Seconds 

0.3736  Seconds 
0.1831  Seconds 
0.2748  Seconds 
0.4207  Seconds 
0.0318  Mword- seconds 
0.0000  Mword- seconds 
0.0110  Mword-seconds 
0.0762  Mwords 
244 
121 
11 

0.0000 


20.  To  excute  model  RCPWAVE,  the  user  types: 


fi.  h2crplcl:larr7$ 


The  CMS  responds: 
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CMS  COMPONENTS 


*  CHSMODEL  (Compiles,  links,  loads,  and  executes 
e  numerical  models) 


Enter  option  nunujer 


The  CMS  responds; 


*  Options: 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid) 


*  CMSPOST  (Plots  and  lists  model  outputs) 

* 

*  CMSUTIL  (Additional  "utility*^  programs) 


*  CMSSAMP  (Sample  Input  files  for  each  model) 


*  Exit  CMS 
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Return  for  more .  .  . 


* 

* 

* 

*■» 

* 

* 

* 

* 

* 

* 

* 

* 

* 


USING  THE  COASTAL  MODELING  SYSTEM 


Options: 

On«Line  Help 

Enter  CMSMODEL  Module 

Return  to  Main  Menu  • 


1 

2 

3 


* 

* 

* 

k* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


Enter  option  number 


The  CMS  responds: 
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f  r  f  t-*  r  r 


* 


Models  Presently  in  System 


CLHYD: 

Curvilinear  Hydrodynamic  2-Dlmensional  Model 

HARfiD: 

Harbor  Wave  Oscillation  Model 

RCPWAVE: 

Regional  Coastal  Processes  Wave  Model 

SPH: 

Standard  Project  Hurricane  Wind  Model 

SWM: 

SPECTRAL  HAVE  MODELING 

SHAIWV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

WIFM: 

WES  Implicit  flooding  Model 

EXIT: 

Terminate  computer  session 

The  user  is  prompted  to  enter  the  name  of  the  model  desired: 


Enter  name  of  model 


The  CMS  responds: 
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Return  for  more . . . 
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For  this  example  RCFWAVE  is  executed  by  responding  to  the  CMS  prompt  with: 

£.  Enter  procedure  name 

The  user  is  prompted  for  the  input  and  output  data  sets  as  follows.  Note  that 
the  names  of  the  user's  input  and  output  files  may  differ  from  those  given  in 
steps  ill  £i  £i  and  g.  Example  input  and  output  file  can  be  found  in 
Chapter  5  (RCFWAVE)  or  can  be  accessed  on-line  using  CMSSAMP  (see  Appendix  D) . 

4.  Enter  name  of  input  data  file 

The  general  output  file  can  be  given  a  default  filename: 

e.  Enter  the  name  of  the  output  data  file 
Default  output  filename  Is  rcuwave.out 

The  ray  plot  data  are  used  to  produce  wave  ray  plots  of  model  results  using 
the  CMSPOST  program  RAYPLT  (see  Appendix  C) . 

Enter  the  name  of  the  output  file  for  ray  plot  data 
Default  output  filename  for  ray  plot  data  is  rcpwave.ang 

The  shoreline  data  are  also  used  with  program  RAYPLT: 

g.  Enter  the  name  of  the  output  file  for  shoreline  data 

Default  output  filename  for  shoreline  data  Is  rcpwave.shl  ^ 

The  system  responds: 


Request  7^80 . tarry  eubmitted  to  queue :  prime . 
END  OF  CMS  PROCEDURE 


This  procedure  launches  a  batch  Job  (number  7280)  to  the  CRAY  Y-MP.  The  viser 
then  has  the  option  of  continuing  to  use  the  CMS  or  exiting  from  the  CMS: 

Do  you  want  to  continue  the  computer  session  ? 

Enter  y[es]  or  [n]o  to  continue  | 
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The  system  responds  with  the  interactive  Job  accounting  svmmary  as  follows: 


Job  Accounting  -  Summary  Report 

Job  Accounting  File  Name 

/tmp/J  tup . 001818a/ . J  acc tl818 

Operating  System 

snl022  larry  6.1  gar. 28  CRAY  Y-MF 

User  Name  (ID) 

h2crplcl  (1432) 

Group  Name  (ID) 

CERC  (105) 

Account  Name  (ID) 

A-cerc  (200) 

Job  Name  (ID) 

1818 

Report  Starts 

06/15/92  10:35:47 

Report  Ends 

06/15/92  10:36:33 

Elapsed  Time 

46  Seconds 

User  CPU  Time 

■■  ■■0:3736 Seconds  ■  ■  '■■'■■'■'■" 

System  CPU  Time 

0.1831  Seconds 

I/O  Wait  Time  (Locked) 

0.2748  Seconds 

I/O  Wait  Time  (Unlocked) 

0.4207  Seconds 

CPU  Time  Memory  Integral 

0.0318  Mword- seconds 

SDS  Time  Memory  Integral 

0.0000  Mword- seconds 

I/O  Wait  Time  Memory  Integral 

0.0110  Hword-seconds 

Data  Transferred 

0.0762  HWords 

Logical  I/O  Requests 

244 

Physical  I/p  Requests 

121 

Ntimber  of  Commands 

11 

Billing  Units 

0.0000 

To  execute  model  CLHYD,  the  user  types; 


A .  h2crplcl : larr7$ 


The  CMS  responds: 
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Return  for  more 


CMS  COMPONENTS 


*  '  Options 


*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid) 


*  CMSMODEL  (Compiles,  links,  loads,  and  executes 

*  numerical  models)  - 


*  CMSFOST  (Plots  and  lists  model  outputs) 


*  CMSUTIL  (Additional  "utility*  programs) 


*  CMSSAMP  (Sample  Input  files  for  each  model) 


Enter  option  number  . . >  || 

The  CMS  responds: 
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USING  THE  COASTAL  MODELING  SYSTEM 


*  Options 


Enter  CMSMODEL  Module 


*  Return  to  Main  Menu 
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Return 

for  more.  .  . 

Enter  option  number  . >  || 


The  CMS  responds: 
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Models  Presently  in  System 


CLHYD: 

Curvilinear  Hydrodynamic  2-Dimensional  Model 

HARBD: 

Harbor  Wave  Oscillation  Model 

RCPWAVE: 

Regional  Coastal  Processes  Wave  Model 

SPH; 

Standard  Project  Htirricane  Wind  Model 

SWM: 

SPECTRAL  WAVE  MODELIMG 

SHALVV:  Time  Dependent  Wave  Model 

STWAVE:  Time  Independent  Wave  Model 

VI FM: 

WES  Implicit  Flooding  Model 

EXIT: 

Terminate  computer  session 

The  user  Is  prompted  to  enter  the  name  of  the  model  desired: 


it.  Enter  name  of  model 


The  CMS  responds; 


CCCCC  L 


H  H  Y  T  DDDDDD 


CCCCC  XXLLLL  H  H 


DDDDDD 


Return  for  more 


Select  Model  Procedure 


BUILD  •  compile  and  link  model 

RUM  >  execute  model 

EXIT  -  tetliinate  computer  eesaion 
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o  e  o 


For  this  example  CLHYD  Is  executed  by  responding  to  the  CMS  prompt  with: 


£.  Enter  procedure  name  jiSp 

The  user  Is  prompted  for  the  Input  and  output  data  sets  as  follows.  Note  that 
the  names  of  the  user's  Input  and  output  files  may  differ  from  those  given  In 
steps  4>  £.>  £•  Example  Input  and  output  files  can  be  found  In  Chapter  6 

(CLHYD)  or  can  be  accessed  on-line  using  CMSSAMP  (see  Appendix  D) . 

Enter  name  of  input  data  file 


A  hotstart  simulation  Indicates  that  model  results  (water  surface  elevations 

and  velocities)  have  been  saved  from  a  previous  simulation  and  are  to  be  used 

as  initial  conditions  for  the  present  simulation; 

£.  Is  this  a  HOTSTART  simulation? 

Enter  yies]  or  n[o]  to  continue  § 

Enter  the  name  of  the  output  data  file 

Hydrograph  data  are  tlme-hlstorles  of  model  results  (l.e.,  water  surface 
elevations  and  velocities)  at  selected  (gage)  points  In  the  computational 
domain. 

g.  Do  you  want  to  save  hydrographic  data? 

Enter  y(es]  or  n(o]  to  continue  |  _ 

Enter  the  name  of  the  hydrograph  data  file 

b.  Do  you  wand  to  save  discharge  range  data? 

Enter  y[es]  or  n[o]  to  continue  ^ 

A  snapshot  is  a  "picture"  of  the  flow  field  for  the  entire  grid  or  a  portion 

of  the  grid  at  a  given  Instant  In  time. 

1.  Do  you  want  to  save  snapshots? 

Enter  y[es]  or  n[o]  to  contlznie  H 

The  system  responds: 


Request  7528.1arry  aubmltted  to  queue:  prime. 

****  end  of  CMS  procedure 


This  procedure  launches  a  batch  Job  (number  7528)  to  the  CRAY  Y-MP.  The  user 
then  has  the  option  of  continuing  to  use  the  CMS  or  exiting  from  the  CMS: 

h.  Do  you  want  to  continue  the  computer  session  ? 

Enter  y[es]  or  [n]o  to  continue  | 
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The  system  responds  with  the  Interactive  job  accounting  summary  as  follows: 


Job  Accounting  -  Summary  Report 

Job  Accounting  File  Name 

/tmp/j  tmp . 001818a/ . j  acctl818 

Operating  System 

snl022  larry  6.1  gar. 28  CRAY  Y-MP 

User  Name  (ID) 

h2crplcl  (1432) 

Group  Name  (ID) 

CERC  (105) 

Accouht  Name  (ID) 

A-cerc  (200) 

Job  N^e  (ID) 

1818 

Report  Starts 

06/15/9210:35:47 

Report  Ends 

06/15/92  10:36:33 

Elapsed  Time 

46  Seconds 

User  CPU  Time 

0*3736  Seconds 

System  CPU  Time 

0.1831  Seconds 

I/O  Wait  Time  (Locked) 

0.2748  Seconds 

I/O  Wait  Time  (Unlocked) 

0.4207  Seconds 

CPU  Time  Memory  Integral 

0.0318  Mwotd-secbnds^^^^  v^ 

SDS  Time  Memory  Integral 

0.0000  Mword- seconds 

I/O  Walt  Time  Memdry  Integral 

0.0110  Mword-seconds 

Data  Transferred 

0.0762  Mwords 

Logical  I/O  Requests 

244 

Physical  I/O  Requests 

121 

Ntifflber  of  Commands 

11 

Billing  Units 

0.0000 
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PART  IV:  CREATING  AND  EDITING  INPUT  FILES  TO  THE  CMS 


Figure  2-1.  Sasple  VlfM  Input  file 


GENSPECS 

WIFM  SIMULATION  NO. 

1:  TIDE  WITHOUT  FEATHERING 

ENGUSH 

TIMBSPEC 

30.  SECONDS 

0. 

86400. 

360. 

GRIDSPEC 

ENGUSH 

75 

30 

500.  1000.  0. 

0.0 

PRWINDOW 

3600. 

m 

RECGAGE 

19  16 

INLET  GAGE 

XBOUNDRYCONSTELV  75 

1 

30 

I  BDRTE 

YBOUNDRYINTRPELV  1 

17 

75 

2  1  BDRYl 

^hKRJNDRYlNTRPELV  30 

17 

75 

2  1  Bom 

FUNCTION 

IHARMCNST 

CNRECORO 

0.0  1981 

6 

1 

2.5 

CONSTIT 

M2  3.97 

199.02 

where  each  variable  occupies  8,  16,  24,  or  32  coluams.  It  Is  reconnended  that 
the  user  refer  to  Chapters  3  and  above  for  specific  model  input  requirements. 

A  portion  of  a  WIEM  Input  file  Is  given  In  Figure  2-1. 


21.  It  is  recommended  that  Input  files  to  the  CMS  be  created  and  edited 
on  the  VAX  8800  or  the  user's  PC,  rather  than  the  CRAY  Y-MP.  The  user  will  be 
more  familiar  with  his  or  her  own  PC,  and  In  addition,  PC  editing  Is  cost- 
free.  The  input  files  can  then  be  transferred  to  the  CRAY  Y-MP  for  use  with 
Che  CMS  (see  Part  V).  However,  PC's  place  an  end-of-flle  marker  (^M)  when 
saving  a  file  and  this  must  be  removed  using  the  CRAY  Y-MP  VI  editor  as 
follows.  To  enter  the  VI  editor  the  user  types: 


<ret>,  then 


<ret> 

<ret> 


<ret> 


i  <ret> 


to  move  to  the  end  of  the  file 

to  move  to  the  end  of  the  current  line 

to  move  left  one  character 

to  move  rl^t  one  character 

to  delete  the  current  character 

to  save  the  file  and  leave  the  editor 


22.  An  Input  file  for  a  given  model  must  conform  to  the  specifications 
outlined  In  the  Individual  model  chapters.  For  example,  omdel  WIFM  requires  a 
TIMESPECS  card  to  conform  to  the  following  specifications: 
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CHAPTER  5 


REGIONAL  COASTAL  PROCESSES  WAVE  PROPAGATION  MODEL 
THEORY  AND  PROGRAM  DOCUMENTATION 

PART  I :  INTRODUCTION 

1.  This  chapter  documents  the  Regional  Coastal  Processes  Wave  (RCPWAVE) 
Propagation  Model.  RCPWAVE  is  a  short-wave  nvunerical  model  used  to  predict 
linear,  plane  wave  propagation  over  an  open  coast  region  of  arbitrary  bathyme¬ 
try.  The  goal  of  regional  modeling  is  to  determine  coastal  changes  resulting 
from  natural  forces  and  man-made  structures  over  an  extensive  length  of 
coastline.  RCPWAVE  uses  linear  wave  theory  because  it  has  been  shown  to  yield 
fairly  accurate  first-order  solutions  to  wave  propagation  problems  and  at  a 
relatively  low  cost.  Refractive  and  bottom- Induced  diffractive  effects  are 
Included  in  the  model;  however,  the  model  cannot  treat  diffraction  caused  by 
surface -piercing  structures.  Application  of  this  model  does  not  include 
nonlinear  effects  nor  a  spectral  representation  of  Irregular  waves. 

2.  RCPWAVE  has  evolved  as  it  has  been  applied  to  wave  propagation 
problems  (Ebersole,  Cialone,  Prater  1986).  The  model  results  can  be  used  as  a 
forcing  function  to  drive  models  that  calculate  longshore  and  cross-shore 
sediment  transport  (Hanson  and  Kraus  1989).  For  example,  RCPWAVE  has  been 
used  in  conjunction  with  the  shoreline  change  model,  GENESIS,  for  mission 
support  projects  at  Homer  Spit,  Alaska  (Chu  et  al.  1987);  Sea  Brl^t  to  Ocean 
Township,  New  Jersey  (Kraus  et  al.  1988);  and  Asbury  Park  to  Manasquan,  New 
Jersey  (Cravens  et  al.  1989). 

3.  Berkhoff  (1972,  1976)  derived  an  elliptical  equation  to  approximate 
the  complete  wave  transformation  process  for  linear  waves  over  arbitrary 
bathymetry  with  the  restriction  of  a  mild  bottom  slope.  By  substituting  the 
velocity  potential  into  the  elliptic  mild  slope  equation  and  solving  the  real 
and  Imaginary  parts  separately,  two  equations  are  derived.  RCPWAVE  solves 
finite  difference  approximations  of  these  equations  along  with  the  equation 
specifying  Irrotationality  of  the  wave  phase  function  gradient  and  the 
dispersion  relation.  These  equations  describe  the  coid>ined  refraction  and 
diffraction  process  for  linear  plane  waves  subject  to  the  restrictions  of  a 
small  bottom  slope.  Wave  reflections  are  assumed  to  be  negligible,  and  any 
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energy  losses  are  assumed  to  be  small  and  can  be  neglected.  These  equations 
are  valid  outside  the  surf  zone. 

4.  The  model  also  contains  an  algorithm  that  estimates  wave  conditions 
inside  the  surf  zone.  This  wave  breaking  model  is  an  extension  of  the  work  of 
Dally,  Dean,  and  Dalrymple  (1984)  to  two  horizontal  dimensions.  The  impor¬ 
tance  of  predicting  wave  transformation  within  the  surf  zone  cannot  be 
overemphasized.  Wave  action  within  the  surf  zone  initiates  sediment  movement, 
and  prediction  of  this  movement  is  a  frequent  goal  of  coastal  modelers. 


Report  Organization 


5.  This  chapter  is  divided  into  five  sections:  Part  II  presents  the 
theoretical  development.  Part  III  defines  the  input  data  formats.  Part  IV 
discusses  the  model's  input  data  requirements,  and  Part  V  contains  two 
illustrative  examples. 
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PART  II:  THEORETICAL  DEVELOPMENT 


Assumptions  and  Limitations 

6.  Proper  application  of  any  model  requires  a  clear  understanding  of 
the  physical  processes  occurring  In  a  study  area  and  a  comprehension  of  the 
capabilities  of  a  given  model  to  simulate  those  processes.  Model  results 
should  provide  a  realistic  representation  of  the  physical  system  being 
modeled. 

7.  The  limitations  of  a  model  define  Its  range  of  applicability.  In 
particular,  RCPUAVE  Is  a  linear,  monochromatic,  short  wave  model.  Therefore, 
nonlinear  effects  and  Irregular  waves  cannot  be  modeled.  RCPWAVE  Is  a  steady- 
state  model;  therefore,  time -dependent  effects  are  not  modeled.  Refractive 
and  bottom- Induced  diffractive  effects  are  Included  In  the  model;  however, 
structure -Induced  diffraction  Is  not.  Model  applications  are  restricted  to  a 
mild  bottom  slope.  Wave  reflection  and  energy  losses  outside  the  surf  zone 
are  assumed  negligible. 

8.  A  thorough  comprehension  of  the  physical  processes  simulated  by  the 
model  Is  necessary  to  ensure  Chat  Che  model  is  applied  Co  appropriate  prob¬ 
lems,  that  it  Is  applied  correctly,  and  that  accurate  results  are  produced.  A 
discuss lor  /  the  governing  equations  used  In  RCPWAVE  is  provided  In  the 
following  section.  It  is  recommended  that  the  reader  refer  to  Horlkawa  (1988) 
or  Dean  and  Dalrymple  (1984)  for  a  detailed  discussion  of  coastal  hydrodynam¬ 
ics,  particularly  linear  wave  propagation. 

Governing  Equations  Outside  the  Surf  Zone 

9.  Berkhoff  (1972,  1976)  derived  an  elliptical  equation  to  approximate 
the  complete  wave  transformation  process  for  linear  waves  over  an  arbitrary 
bathymetry  with  the  restriction  of  a  mild  bottom  slope.  Berkhoff' s  "mild 
slope"  equation  Is; 


d 


KIE)  * 


+  o’  ^  4*0 
c 


(5-1) 
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where 


X,  y 

- 

two  orchogonal  horizontal  coordinate  directions 

(x.y) 

aw 

wave  celerity  (-  a/k) 

a 

- 

angular  wave  frequency  (defined  to  be  2x/T) 

k(x,y) 

wave  number  given  by  the  dispersion  relation 
-  gk  tanh  (kh) 

T 

- 

wave  period 

Ci(x.y) 

- 

group  velocity  (da/dk) 

4>(x,y) 

- 

complex  velocity  potential 

g 

- 

acceleration  due  to  gravity 

h(x,y) 

- 

still -water  depth 

10.  If  one  considers  only  the  forward  scattered  wave  field  and  neglects 
wave  reflection,  the  velocity  potential  function  for  linear,  monochromatic 
plane  waves  can  be  given  as: 

4,  =  (5-2) 

where 

^(x,y)  -  wave  amplitude  function  [gH(x,y)/2a] 

H(x,y)  -  wave  height 

s(x,y)  -  wave  phase  function 

11.  By  substituting  Equation  5-2  into  Equation  5-1  and  solving  the  real 
and  Imaginary  parts  separately,  two  equations  can  be  derived: 

lii!5  +  [Va  •  V(ccJ]  I  +  Jt*  -  |Vs|*  =  0  (5-3) 

V  •  (a^cCyVs)  ■  0  (5-4) 

where  the  symbol  ^  denotes  the  horizontal  gradient  operation.  These 
equations  describe  the  combined  refractive-diffractive  process. 

12.  Linear  wave  theory  assumes  irrotatlonallty  of  the  wave  phase 
function  gradient.  This  property  can  be  expressed  mathematically  as: 

Vx(Vs)  *  0  (5-5) 

The  phase  function  gradient,  Vs  ,  can  be  written  in  vector  notation  as 
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Vs  =  |Vs|cosdi  +  |Vs|sin6j 


(5-6) 


where 

i,  J  -  unit  vectors  in  the  x-  and  y-directions ,  respectively 

I  Vs  I  -  magnitude  of  the  phase  function  gradient 
6  -  local  wave  direction 

Equations  5-5  and  5-6  can  be  combined  to  yield  the  following  expression: 

-J^dVsl  ain6)  -  -^(iVslainO)  =  0  (5-7) 

If  the  magnitude  of  the  wave  phase  function  gradient  is  known,  local  wave 
angles  can  be  calculated  from  Equation  5-7.  Similarly,  Equation  5-4  can  be 
expressed  as: 

-^(a*cCy|Vs|  coa6)  ♦  (a*cCy |Vs|  ainO)  =  0  (5-8) 

Equation  5-3  is  solved  for  the  magnitude  of  the  wave  phase  function  gradient, 

I  Vs  I  ;  Equation  5-7  is  solved  for  the  wave  angle,  $  ;  and  Equation  5-8  is 
solved  for  the  wave  amplitude  function,  a  .  Equations  5-3,  5-7,  and  5-8 
along  with  the  dispersion  relation  describe  the  combined  refractive- 
diffractive  process  for  linear  plane  wave  propagation  over  a  mild  slope  with 
negligible  wave  reflection  and  energy  losses. 

Numerical  solution 

13.  Numerical  methods  are  used  to  solve  the  three  governing  equations 
described  previously.  Analytical  solutions  of  the  governing  equations  may 
exist  for  Idealized  situations.  However,  It  Is  generally  necessary  to  use 
numerical  approximations  of  the  governing  eqviatlons  to  provide  a  more  general 
solution.  This  Is  accomplished  by  approximating  the  partial  derivatives  with 
finite  difference  operators  (l.e.  resolving  the  continuous  domain  of  Interest 
with  discrete  spatlcl  Increments) .  Finite  difference  solution  methods 
operate  on  a  computational  grid  system.  Solution  accuracy  Is  directly  related 
to  resolution  within  the  grid  system. 

14.  The  coordinate  system  convention  adopted  by  RCPWAVE  is  oriented 
with  the  x-axls  In  the  on-offshore  direction  and  the  y-axls  alongshore 
(Figure  5-1).  The  grid  cells  have  consti^nt  lengths  of  DX  and  DY  In  the  x-  and 
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ranges 


y-directions ,  respectively.  The  cell  counter  in  the  x-direction,  i  , 
from  1  to  a  maximum  value  of  XCELLS.  The  cell  counter  in  the  y-direction, 

J  ,  ranges  from  1  to  a  maximum  value  of  YCELLS. 

15.  As  previously  stated,  the  partial  derivatives  in  the  governing 
equations  are  approximated  with  finite  difference  operators .  The  first  and 
second  derivatives  of  ai  arbitrary  dependent  variable,  say  F,  are  approximated 
with  the  following  finite  difference  operators: 


Figure  5-1.  Definition  of  coordinate  system 
and  grid  cell  convention 
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16.  Equations  5-10  and  5-12  are  central  differences,  and  Equations  5-9 
and  5-11  are  backward  differences  of  the  sane  order  of  accuracy.  Backwards 
differences  are  used  to  approximate  the  derivatives  in  the  x-dlrectlon  because 
of  the  forward  (-x-dlrectlon)  marching  scheme  used  in  the  model. 

17.  These  difference  equations  can  be  used  to  approximate  the  partial 
derivatives  in  Equation  5-3: 

|Vg|i  i  =kji  *  ~  ~  (5-13) 

(Ax)» 


+  1 

(Ay)* 

(  2Ax  J 

(  (2Ax)  j 

1  2Ay  j 

1  (2Ay)  J  J 

The  remaining  two  governing  equations,  5-7  and  5-8,  have  the  general  form: 


dF 

Ik 


+ 


(5-14) 


The  partial  derivatives  In  equation  5-14  can  be  approximated  using  central 
differences  about  the  point  (1-1/2 ,J).  The  final  form  of  Equations  5-7  and 
5-8  are: 

sinOi.i.j  =  +  (1  -  2a)  |Vsli,jsin0i,j 


(5-15) 


-  cosOi.j-i)] 


and 
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af-i. 


Ai- 


i.J 


[  +  (1  -  2a)aljAi^j  + 


(5-16) 


WAx 

2Ay 


(1  -ftOAx/_2 
2  Ay 


i,  J»1 


where 

A  - 
B  - 

W  ,  a  - 
The  parameter 
solution  row, 
is  performed. 


ccg I  Vs  I  cos  , 
cCg|Vs|  sin 
weighting  factors 

W  weights  information  between  the  known  row,  i  ,  and  the 
i-1.  If  W  is  1.0,  then  an  implicit  solution  of  the  equation 
If  W  is  0.0,  then  an  explicit  solution  of  the  equation  is 
performed.  The  weighting  parameter  a  reflects  use  of  a  dissipative  inter¬ 
face  to  enhance  the  stability  of  the  numerical  scheme  (Abbott  1975) . 

Solution  procedure 

18.  The  following  procedure  is  implemented  in  the  model  to  solve 
finite  difference  Equations  5-13,  5-15,  and  5-16: 


a.  Model  input  includes  values  of  the  deepwater  wave  height. 

Ho  ,  direction,  ,  and  period,  T  ,  of  the  waves  to  be  simu¬ 
lated  along  with  bathymetric  data  for  every  grid  cell. 

fe.  The  wave  number,  k  ,  is  computed  using  the  dispersion  relation 
and  is  used  as  an  initial  ^ess  for  the  magnitude  of  the  wave 
phase  function  gradient,  |Vs|  ,  at  every  grid  cell. 

c.  The  wave  celerity,  c  ,  and  the  group  velocity,  Cg  ,  are  func¬ 
tions  of  the  wave  period  and  wave  number  and  can,  therefore,  be 
calculated  at  each  grid  cell. 

An  estimate  of  the  local  wave  angle,  6  ,  can  be  calculated 

throughout  the  grid  using  this  information  and  Snell's  law. 


sin6  _  (5-17) 


where  is  the  deepwater  wave  celerity  (gT/2>r)  .  This  esti¬ 

mate  assumes  that  the  bottom  contours  are  parallel  to  the  y- 
axls.  If  the  bottom  bathymetric  contours  make  a  known  nonzero 
angle,  6^  ,  with  the  y-axis  (Figure  5-2),  a  better  first  guess 
for  the  wave  angles  can  be  computed  using  the  following  approx¬ 
imation: 
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6  *  It 


sin" 


I  sin  (0„  -  ej 


C 


♦0. 


(5-18) 


e.  Wave  heights  at  each  cell  are  estimated  as  the  product  of  the 
deepwater  wave  height,  ,  the  shoaling  coefficient,  k,  , 
and  the  refraction  coefficient,  »  where 


r  1  1 

-  2kh  ] 

tanh  Ikh) 

i  sinh  (2Jch) 

(5-19) 


and 


I  cos  (8o-0e)  (5-20) 

\  cos  (0-0^)  j 


Y  -  MB 


e  -  LOOM.  WAVE  ANGLE 

8,  -  OFTSHOf^  CONTOUR  ANGIE 

Figure  5-2.  Definition  of  angle  conventions 
tised  in  the  model 
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19.  Following  the  determination  of  the  initial  guess  for  the  variables 
of  interest,  a  row-by-row  marching  scheme  is  implemented.  Computations  begin 
at  the  offshore  row  designated  (i-XCELLS-3) ,  where  a  solution  for  wave  angles, 
heights,  and  numbers  is  determined  for  cells  j-2  to  j-YCELLS-1. 

20.  The  implicit  differencing  formulation  used  in  Equations  5-15  and  5- 
16  requires  an  iterative  procedure  to  determine  values  of  wave  height  and 
angle.  Calculations  are  repeated  until  a  convergence  criterion  is  met. 
Convergence  for  wave  height  is  achieved  when  the  difference  between  the  wave 
height  computed  from  one  iteration  to  the  next  iteration  is  less  than  a  small 
value  (0.0005  ft).  Similarly,  convergence  for  wave  angle  is  achieved  when  the 
difference  between  the  wave  angle  computed  from  one  iteration  to  the  next 
iteration  is  less  than  a  small  value  (0.00025  rad).  The  third  governing 
equation  (5-13)  is  used  to  compute  the  wave  phase  gradient  that  accounts  for 
the  effects  of  diffraction. 

21.  Equations  5-15  and  5-16  are  solved  again  with  the  new  values  of  the 
wave  phase  function  gradient.  This  procedure  is  repeated  along  the  row  under 
consideration  until  the  phase  functions  satisfy  a  convergence  criterion  (i.e., 
the  difference  in  the  phase  functions  between  consecutive  iterations  is  less 
than  0.5  percent).  This  condition  must  be  met  at  each  cell  along  the  row. 

Row  by  row  marching  proceeds  until  a  solution  is  computed  along  row  i-2. 
Boundary  conditions 

22.  Lateral  boundary  conditions  for  a  row  are  specified  upon  completion 
of  calculations  for  that  row.  The  values  of  all  variables  at  cells  J-YCELLS 
and  j-1  are  set  equal  to  the  values  at  cells  j-YCELLS-1  and  j-2,  respectively. 
This  boundary  condition  Implies  that  there  is  no  change  in  wave  properties  in 
the  y-directlon.  This  condition  is  most  valid  when  the  grid  y-axis  parallels 
the  bathymetric  contours. 

23.  The  seaward  boundary  condition  (deepwater  wave  parameters)  are  used 
to  initiate  the  shoreward  marching  procedure.  Values  along  the  seaward 
boundary  are  computed  from  deepwater  wave  input,  assuming  Snell's  law  is  valid 
(i.e.,  the  bottom  contours  are  straight  and  parallel  from  the  grid  boundary  to 
deep  water) .  No  inshore  boundary  condition  (row  I  -  1)  is  necessary  because 
of  the  forward  marching  scheme  implemented  in  the  model. 
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Wave  transformation  Inside  the  surf  zone 

24.  Since  linear  wave  theory  does  not  allow  for  the  prediction  of  the 
breaker  location  nor  for  wave  transformation  across  the  surf  zone,  empirical 
and  approximate  methods  must  be  used  to  describe  incipient  wave  breaking  and 
the  subsequent  decay  of  energy.  Many  empirical  methods  give  reasonable 
approximations  of  incipient  breaking  wave  height.  RCPWAVE  uses  Weggel's 
(1972)  criterion,  which  was  developed  by  fitting  an  empirical  relationship  to 
field  data  on  breaking  waves ; 


1 


bh^ 

♦ 


(5-21) 


where 

k  -  43.75  [  1  -  ] 

b  -  1.56  /  [  1  +  ] 

m  -  bottom  slope 
Hj,  »  breaking  wave  height 
h),  -  water  depth  at  breaking 

25.  After  defining  the  Incipient  breaking  point,  a  means  of  transform¬ 
ing  the  waves  across  the  surf  zone  is  needed.  Dally,  Dean,  and  Dalrymple 
(1984)  developed  an  algorithm  to  approximate  energy  loss  across  the  entire 
surf  zone  based  on  energy  loss  in  a  hydraulic  Jump. 


a  (EC.) 


=  ^  lEc,  -  (EC,).] 


(5-22) 


where 

K  -  energy  dissipation  coefficient  (set  to  0.2  in  RCPWAVE) 

(Ecg)  -  energy  flux  associated  with  a  breaking  wave 

(Ecg).  -  stable  level  of  energy  flux  that  the  transformation  process 
seeks  to  attain 

The  right-hand  side  of  Equation  5-22  is  simply  a  dissipative  term.  Substitut 
ing  the  linear  wave  theory  estimate  for  E  (E  -  1/8  pgH^)  into  Equation  5-22 
results  in  the  following  expression: 
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(5-23) 


dx 


[H^c^  - 


=  D 


26.  It  has  been  observed  in  field  (Thornton  and  Guza  1982)  and  labora¬ 
tory  (Horikawa  and  Kuo  1966)  experiments  that,  well  into  the  surf  zone,  the 
wave  height  tends  toward  a  stable  value  that  is  proportional  to  the  local 
water  depth; 

H,  ^  yh  (5-24) 


where 

Hg  —  stable  wave  height 

7  -  proportionality  coefficient  (set  equal  to  0.4  in  RCPWAVE) 

Equation  5-23  can  now  be  written  as 

^ [»»c.  -  (5-25) 

27.  This  surf  zone  wave  transformation  model  can  be  incorporated  into 
the  conservation  of  wave  energy  equation  (Equation  5-4)  by  simply  adding  the 
dissipation  term  D  to  the  right-hand  side.  The  function  D  must  now 
represent  dissipation  in  the  direction  of  wave  propagation.  Also  for  dimen¬ 
sional  consistency,  the  term  D  must  be  multiplied  by  the  wave  celerity  and 
the  magnitude  of  the  wave  phase  gradient,  and  the  wave  height  must  be  replaced 
by  the  wave  amplitude  function.  In  vector  notation,  the  energy  equation 
becomes 

V»(a*cCyVs)  =  -^|a*cc^|V«|  -  |  l-^l^y^h^cc^lVslj  |  (5-26) 

This  equation  can  be  thought  of  as  being  valid  both  inside  and  outside  the 
surf  zone.  Outside,  the  coefficient  k  is  zero,  and  the  equation  reduces  to 
Equation  5-4. 

28.  Discussion  relating  to  wave  transformation  within  the  surf  zone  has 
addressed  the  problem  of  determining  wave  heights.  The  problem  of  wave  phase 
must  also  be  addressed.  Diffractive  effects  are  assumed  to  be  negligible 
Inside  the  surf  zone.  Therefore,  the  wave  number,  k  ,  is  assumed  to 
accurately  represent  the  wave  phase  function  gradient  in  the  surf  zone. 
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29.  Lastly,  the  linear  wave  theory  assumption  of  Irrotatlonallty  also 
will  be  assumed  to  remain  valid  Inside  the  surf  zone.  Consequently,  wave 
angles  Inside  the  surf  zone  are  computed  In  the  same  manner  that  Is  used 
outside  the  surf  zone. 

Numerical  solution 

30.  The  numerical  procedure  for  computing  wave  angles  Inside  and 
outside  the  surf  zone  Is  the  same.  This  section  documents  the  solution  scheme 
used  to  determine  breaking  wave  heights.  The  finite  difference  form  of  the 
wave  energy  equation  outside  the  surf  zone  (Equation  5-16)  can  be  expressed  In 
the  following  form: 


^2  _  F  *  AxG  (5-27) 

Si-i.i - j - 

where 

F  -  +  (1  -  2a)aljAi^j  * 

G  -  (1  -  no  , 

B  »  cc^|Vs|  8in6  ,  and 
A  -  cc^|Vs|cos0. 

With  the  Inclusion  of  the  dissipative  term,  Equation  5-27  becomes 

_2  _  F  AxG  ^  AxD*  (5-28) 

~A -  a - 

where  D*  represents  the  finite  difference  form  of  the  dissipation  term  on 
the  rlgbt-hand  of  Equation  5-26.  Reiterating,  the  dissipation  term  represents 
an  average  value  along  the  wave  path  (direction  of  propagation) .  The  wave 
path  Is  determined  by  the  local  wave  angle  at  the  position  i-l,J  which  has 
already  been  computed.  Therefore,  the  average  along  the  path  is  an  average  of 
Information  at  cell  i-l,J  and  another  cell  whose  position  is  denoted  by 
Ikey ,Jkey .  The  procedure  used  for  determining  the  location  of  this  cell  will 
be  presented  later. 

31.  The  term  D  can  be  written  in  finite  difference  form  as 
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D 


(5-29) 


2 


Y^A^gCg|Vs|iJr»v.jJc«y  ^  Y^^^ggg|Vg|i-l.  j  j| 


where 


h  =  ^  ^ikey.ikev 

2 

With  some  algebra,  Equation  5-28  can  be  reorganized  so  that  the  amplitude 
function  at  the  position  i-l.J  appears  only  on  the  left-hand  side  of  the 
equation.  Therefore,  the  energy  equation  inside  the  surf  zone  can  be  numeri¬ 
cally  solved  using  the  same  procedure  used  to  solve  it  outside  the  surf  zone. 

32.  The  location  of  the  cell  denoted  ikey,Jkey  is  found  using  the 
following  procedure.  "Areas  of  influence"  are  determined  by  extending  lines 
from  the  center  of  the  cell  i-I,J  to  the  midpoints  between  the  surrounding 
cell  centers  (Figure  5-3).  Angles  are  computed  from  the  x-axis  to  these 
radial  lines.  The  local  wave  angle  calculated  at  cell  i-l,J  is  compared  with 
each  of  these  angles  in  order  to  determine  the  nearest,  prior  cell  (in  row  i) 
along  the  wave  path.  For  example  (refer  to  Figure  5-3),  if  the  local  wave 
angle  is  greater  than  02  but  less  than  Si  ,  then  cell  i,J+l  is  the  cell  of 
influence  and  ikey  -  i  and  Jkey  -  J+1 . 


j-1  j  j+1 
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Figure  5-3.  Cells  of  influence  used  in  wave 
breaking  scheme 
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33.  A  flowchart  describing  the  wave  height  computation  is  shown  in 
Figure  5-4.  The  wave  amplitude  function  is  computed  from  the  energy  equation 
assuming  no  dissipation.  The  amplitude  function  is  converted  to  wave  height 
and  compared  with  the  stable  wave  hei^t  yh  .  If  the  wave  is  less  than  or 
equal  to  this  stable  level,  the  wave  has  broken  and  attained  a  stable  height, 
or  it  is  outside  the  surf  zone  and  unbroken.  In  either  case,  no  consideration 
of  dissipation  is  needed.  If  the  wave  hei^t  is  greater  than  -fb  ,  the  cell 
of  Influence  is  located  and  tested  to  determine  whether  or  not  the  wave  is 
breaking.  If  the  wave  is  breaking  in  the  cell  of  influence,  it  continues  to 
decay  in  height.  If  the  wave  in  the  cell  of  influence  is  not  breaking,  the 
local  wave  height  is  checked  against  the  incipient  breaking  height  criterion. 
If  the  height  exceeds  the  allowable  value,  wave  dissipation  begins.  The 
accuracy  of  the  surf  zone  wave  transformation  model  has  been  verified  using 
laboratory  data  of  Horikawa  and  Kuo  (1966)  and  Izumlya  (1984) .  Results  of  the 
comparisons  can  be  found  in  Ebersole,  Cialone,  and  Prater  (1986). 

Computational  stability 

34.  In  applying  RCPWAVE,  it  has  been  determined  that  the  aspect  ratio, 
Ay/Ax  ,  plays  an  important  role  in  determining  the  computational  stability  of 
the  numerical  solution  scheme.  The  maximum  allowable  local  wave  angle  is 
defined  as  the  inverse  tangent  of  the  ratio  Ay/ Ax.  Therefore,  larger  wave 
angles  can  be  resolved  by  the  model  as  this  ratio  increases  (Figure  5-5). 

35.  Computational  instability  occurs  when  no  energy  reaches  a  cell  in 

the  computational  domain.  Implying  a  zero  wave  height.  This  instability  may 
occur  when  a  cell  (i,J)  passes  energy  to  cell  while  cell  (i,J-I) 

passes  energy  to  cell  (i-l.J+I)  (Figure  5-6a).  Cell  receives  no 

energy  and  therefore  is  assigned  a  zero  wave  height.  The  diffractive  portion 
of  the  model  cannot  recover  from  this  situation.  For  irregular  bathymetry, 
stability  problems  can  occur  when  large  bathymetry  gradients  cause  strong  wave 
refraction  and  local  wave  angles  become  large.  Strongly  oblique  wave  inci¬ 
dence  is  not  a  problem  for  plane  beach  simulations  because  every  cell,  J— 1  to 
J-YCELLS,  in  a  given  row,  J  ,  behaves  identically;  therefore,  energy  is 
uniformly  passed  to  every  cell  in  row  i-1  (Figure  5-6b). 
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Compute  Wave  Amplitude  Function  a 


•  1 

Convert  Wave  Function  to  Wave  Height  H 


.  Find  Cell  of  Influence  (Ikey,  Jkey) 

1 

Waa  Wave  Broken  In  Cell  of  Influence 


Compute  Breaking  Depth  h^  from  Weggel'e 
Empirical  Relationship 


Recompute  Wave  Amplitude  Function  from 
Energy  Equation  with  Dissipation  Terms  Included 


Continue  to  Next  Computational  Cell  and  Repeat 


Figure  5*4.  Flowchart  of  the  wave  breaking  scheme 
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Figure  5-6.  Schematic  of  wave  energy  passing  from  row  i  to  row  i-1 
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PART  III:  DEFINITION  OF  INPUT  DATA  FORMAT 


36.  The  input  data  set  format  was  designed  to  resemble  the  format 
required  by  the  series  of  models  released  by  the  USAE  Hydrologic  Engineering 
Center.  It  is  the  intent  that  this  structure,  being  familiar  to  Corps 
personnel,  will  reduce  the  time  needed  to  learn  this  system.  The  general 
format  of  the  input  data  set  records,  where  a  record  refers  to  one  line  of 
data,  is  presented  below: 


a.  Each  record  is  divided  into  10  fields  containing  8  columns 
each. 

b.  Field  1,  columns  1  through  8,  contains  a  mnemonic  identifica¬ 
tion  label  that  describes  the  purpose  or  function  of  each 
record. 

c.  Fields  2  through  10  contain  data  that  may  be  real,  integer,  or 
character  in  type.  Integers  must  be  right  justified.  Real 
numbers  must  also  be  right- justified  if  the  decimal  point  is 
omitted.  Character  data  does  not  need  to  be  right-  or  left- 
justified. 

d.  Array  data,  such  as  depths,  are  read  with  DO  or  Implied  DO 
loops.  No  label  is  required  for  each  record  containing  array 
data.  However,  a  general  specification  record,  such  as  BATHS - 
PEC  which  defines  bathymetric  attributes,  must  precede  that 
array . 


37.  Spelling  of  record  identification  labels  and  alphanumeric  variables 
is  important.  Misspelled  entries  will  result  in  either  recognized  error 
conditions  that  force  the  model  to  abort  execution,  or  bypassing  of  desired 
user-defined  operations,  such  as  bathymetric  changes. 

38.  Certain  records  and  variables  have  been  assigned  default  values  in 
the  model  for  minimizing  input  data  and  computer  resources.  Thus,  not  all 
input  data  records  will  be  needed  for  each  application,  and  only  those  records 
pertinent  to  the  simulation  or  required  hr  the  model  should  be  included. 
Default  values  are  representative  of  those  chosen  in  previous  studies  per¬ 
formed  by  Coastal  Engineering  Research  Cente’'  (CERC)  staff.  Although  these 
quantities  may  not  be  applicable  to  all  s^'udies,  they  can  serve  as  a  guide 
when  selecting  replacement  valm’’. 

39.  Default  values  are  processed  when  the  record  field  corresponding  to 
that  variable  is  blank.  Hence,  the  user  must  be  careful  when  leaving  fields 
blank  in  a  record;  blank  fields  will  not  necessarily  result  in  a  variable 
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being  assigned  a  value  of  zero.  These  variables  and  their  respective  default 
values  are  noted  in  Appendix  5- A.  The  following  discussion  pertains  to  the 
general  format  of  the  input  records  given  in  Appendix  5-A. 

40.  Each  record  is  presented  in  a  standardized  tabular  format  and  has 
as  its  heading  the  mnemonic  identification  label  or  name  with  a  brief  descrip¬ 
tion  of  its  function.  Following  its  name,  the  record  has  an  abbreviated  note 
documenting  whether  it  is  required  for  a  simulation.  These  abbreviations  have 
the  following  definitions: 

(Req)  Record  or  variable  is  required  for  each  simulation. 

(Opt)  Record  or  variable  is  optional.  Omitting  this  item 

results  in  either  the  default  value  being  used  or  the 
defined  operation  not  being  performed. 

For  example,  record  BATHSPEC,  presented  in  Appendix  5-A,  contains  the  note 
(Req)  meaning  that  this  record  must  reside  in  the  input  data  set  for  each 
simulation.  Record  CHNGBATH  contains  the  note  (Opt)  meaning  this  record  is 
optional  and  is  only  used  when  changes  to  the  bathymetric  data  are  desired. 

41.  Input  variables,  presented  in  column  2  of  each  table,  are  refer¬ 
enced  to  their  respective  record  fields  shown  in  column  1.  Generally,  data 
for  each  variable  occupy  a  single  8-column  data  field.  However,  variables 
assigned  titling  or  formatting  information  can  occupy  several  fields. 

42.  Variable  attributes  are  presented  in  columns  3  through  6  of  each 
table.  Valid  data  types  are  listed  in  coliann  3  and  can  be  real.  Integer,  or 
alphanumeric.  Abbreviations  presented  in  this  column  are  described  below: 

Char*16  Alphanumeric  character  string  containing  up  to  16 

characters 

Charts  Alphanumeric  character  string  containing  up 

to  8  characters 

Integer  Integer  data 

Real  Real  (floating  point)  data 

43.  Column  4  of  each  table  defines  whether  the  respective  variable  must 
be  assigned  a  value.  Abbreviations  listed  in  this  column  have  identical 
meanings  as  those  for  the  records.  Default  values  are  listed  in  column  5.  A 
blank  entry  in  this  column  denotes  that  the  respective  variable  is  not 
assigned  a  default  value. 
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44.  Colvunn  6  of  each  table  lists  the  variables'  permitted  data  type  or 
all  valid  character  strings.  Variables  having  integer  or  real  data  types  are 
specified  with  the  following  notation: 

A  Alphanumeric  values 

+R  Positive  real  values 

R  Positive,  zero,  or  negative  real  values 

+I  Positive  integer  values 

I  Positive,  zero,  or  negative  integer  values 


45 .  Variable  definitions  are  listed  in  table  column  7  of  each  table . 
Variables  whose  quantities  are  unit-dependent  contain  a  reference  to  that 
variable  designating  its  system  of  units.  For  example,  variable  WDATUM  is 
assigned  a  value  having  units  defined  by  variable  BUNITS.  Variables  defining 
input  data  units  and  the  record  on  which  they  reside  are  presented  below. 


Variable  Record 

BUNITS  BATHSPEC 

GUNITS  GRIDSPEC 

SUNITS  GENSPECS 


_ Definition _ 

bathymetry/topography  data 

numerical  grid  data 

model  computations  and  output 
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Part  IV;  DISCUSSION  OF  THE  INPUT  DATA  REQUIREMENTS 


46.  The  types  of  data  processed  by  RCPWAVE  are  not  extremely  extensive. 
However,  since  each  application  Is  unique,  the  type  of  Input  data  required  for 
each  study  will  vary.  In  this  discussion  of  model  Input,  data  have  been 
divided  Into  four  categories  to  present  model  capabilities  and  data  require¬ 
ments.  These  categories  are: 

a.  Model  control  specifications. 

b.  Grid  description. 

c.  Physical  characteristics. 

<|.  Output  specifications. 

47.  Table  5-1  presents  RCPWAVE  Input  data  records  pertaining  to  each 
category.  A  record  refers  to  one  line  of  data,  and  each  record  begins  with  a 
mnemonic  character  string  to  Identify  one  record  type  from  another.  Record 
format  and  detailed  specification  for  each  record  are  presented  In  this 
chapter.  While  reading  Part  IV,  the  user  will  find  It  beneficial  to  refer  to 
Appendix  5 -A. 


Model  Control  Parameters 

48.  The  only  data  record  contained  In  this  category  is  the  GENSPECS 
record.  Record  GENSPECS  Is  used  to  specify  the  general  title  of  the  simula¬ 
tion  (TITLE)  and  the  system  of  units  (SUNITS)  used  for  model  computations  and 
displaying  model  results.  Variable  names  are  given  in  parentheses.  Addition 
al  titles  may  be  selected  for  specific  input  data  records.  Althou^  this 
Information  is  optional,  it  can  be  very  helpful  when  reviewing  a  series  of 
simulations.  A  title  should  specifically  state  data  attributes,  such  as  data 
source  or  collection  date,  to  differentiate  from  data  used  in  other 
simulations. 

49.  Model  output  is  displayed  in  either  English  or  metric  units. 
However,  the  user  can  specify  a  different  system  of  units  for  the  input  data. 
For  example,  the  user  can  supply  bathymetry  data  having  units  of  feet  or 
meters.  RCPWAVE  will  convert  the  input  data  into  the  necessary  system  of 
units . 
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Table  5-1 

Input  Data  Set  Records 

Cateeorv 

Record  Name 

Model  control  specifications 

GENSPECS 

Grid  description 

GRIDSPEC 

Physical  characteristics 

BATHS PEC 

CHNGBATH 

WAVCOND 

WAVMOD 

CONVERG 

Output  specifications 

PRWINDOW 

PLOTREC 

SAVESPEC 

Grid  Description 

50.  The  study  area  is  defined  in  the  model  via  a  computational  grid. 

The  grid  is  composed  of  rectilinear  cells,  where  each  cell  is  assigned  a  two- 
dimensional  index.  The  first  index,  I  ,  corresponds  to  the  x-coordinate,  and 
the  second  index,  j  ,  corresponds  to  the  y-coordinate.  The  grid  index  system 
was  presented  in  Figure  5-1.  All  wave  data,  such  as  wave  heights,  are 
assigned  and  referenced  to  their  respective  grid  cells  with  this  system. 
Guidelines  for  developing  grids  are  discussed  in  Appendix  A  of  the  CMS  User’s 
Manual . 

51.  Selection  of  a  grid  coordinate  system  is  controlled  by  variable 
GRTYPE  on  record  GRIDSPEC.  RCPUAVE  permits  a  rectilinear  uniform  grid 
coordinate  system  only.  A  uniform,  or  constant  grid  cell  size  is  selected  by 
assigning  the  character  string  RECTANG  to  variable  GRTYPE. 

52.  Variable  GUNITS  on  record  GRIDSPEC  controls  the  system  of  units  for 
the  computational  grid.  Valid  units  are  feet  r  .d  meters.  RCPWAVE  will 
convert  the  data  to  the  system  of  units  for  computations  (SUNITS)  internally. 
Variables  XCELLS  and  YCELLS  specify  the  number  of  grid  cells  in  the  x-  and 

y 'directions,  respectively.  Variables  DX  and  DY  on  record  GRIDSPEC  specify 
the  grid's  cell  size  in  the  x-  and  y-directions,  respectively. 
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Physical  Characteristics 


Topography /bathymetry 

53.  Each  grid  cell  must  be  assigned  a  water  depth  or  land  elevation. 
Topography /bathymetry  data  are  referenced  relative  to  an  arbitrary  datum. 
Typically,  the  map  datum  from  which  the  depths  are  taken  is  used.  Water  cells 
are  designated  by  negative  values,  whereas  land  cells  have  positive  values. 

54.  One  BATHSPEC  record  is  required  for  defining  the  general  charac¬ 
teristics  of  the  topography/bath3rmetry  array  and  must  precede  this  array. 
Variable  BUNITS  defines  the  \uilts  of  topography/bathymetry  data.  Valid  units 
are  feet,  meters,  or  fathoms.  The  input  sequence  for  reading  this  array  is 
controlled  by  variable  BSEQ.  Eight  options  for  the  input  sequence  are 
available  for  reading  the  array  data  and  are  documented  in  Table  5-2.  As  an 
example,  for  the  first  input  sequence  (Figure  5-7),  the  depths  are  read  along 
the  X- direction,  then  y  is  Incremented  to  a  value  of  2,  and  again  the  sweep  in 
the  x-directlon  takes  place.  This  procedure  is  repeated  until  the  entire 
array  is  read.  The  input  format  for  reading  this  array  can  be  selected  by  the 
user  with  variable  BFORM. 

55.  The  maximum  water  depth  is  specified  with  variable  DLIMIT  and  any 
array  values  deeper  than  DLIMIT  are  set  to  DLIMIT  (in  BUNITS).  Grid-wide 
adjustments  to  land  elevations  contained  in  the  topography/bathymetry  array 
can  be  made  with  variable  LDATUM.  The  value  assigned  to  this  variable  is 
added  to  all  land  cells  in  the  grid.  Positive  LDATUM  values  will  increase 
land  elevations,  whereas  negative  values  will  decrease  land  elevations. 
Similarly,  grid-wide  adjustments  to  water  depths  can  be  made  with  variable 
WDATUM.  The  value  assigned  to  this  variable  is  added  to  all  water  cells. 

Since  these  cells  have  negative  values,  positive  WDATUM  values  produce 
shallower  depths. 

56.  Changes  to  the  topography/bathymetry  array  can  also  be  made  to 
individual  cells  or  a  group  of  cells  with  record  CHNGBATH.  This  record 
allows  the  user  to  quickly  change  values  assigned  to  the  bathymetry  array 
(using  variable  BATH)  without  editing  the  array  itself.  It  should  be  noted 
that  (a)  values  of  the  variable  BATH  on  the  CHNGBATH  record  are  assumed  to 
have  units  consistent  with  those  selected  for  bathymetry/topography  (i.e., 
variable  BUNITS  on  record  BATHSPEC) ,  and  (b)  LDATUM  and  WDATUM  are  not  applied 


5-23 


Table  5-2 

Input  Sequence  for  Array  Data 


lia 

Seauence 

Description 

1 

XY 

1 

DO  1  J-1,YCELLS 

READ(LUN,FORM)  (VAR(I , J) , I-l .XCELLS) 

2 

-XY 

2 

DO  2  J-1,YCELLS 

READ(LUN,FORM)  (VAR(I , J) , I-XCELLS , 1 . *1) 

3 

X-Y 

3 

DO  3  J-YCELLS, 1,-1 

READ (UJN, FORM)  (VAR(I ,J) , I-l .XCELLS) 

4 

-X-Y 

4 

DO  4  J-YCELLS, 1,-1 

READ(LUN,FORM)  (VAR(I.J) , I-XCELLS, 1, -1) 

5 

YX 

5 

DO  5  1-1, XCELLS 

READ(LUN.FORM)  (VAR(I . J) , J-1 . YCELLS) 

6 

-YX 

6 

DO  6  I-l, XCELLS 

READ (UJN, FORM)  (VAR(I ,J) , J-YCELLS , 1 . -1) 

7 

Y-X 

7 

DO  7  I-XCELLS, 1,-1 

READ(LUN,FORM)  (VAR(I ,J) , J-1 .YCELLS) 

8  -Y-X  DO  8  I-XCELLS,1,-1 

8  READ(LUN,FORM)  (VAR(I , J) , J-YCELLS , 1 . 'D 


to  cells  specified  with  record  CHNGBATH;  therefore,  the  effect  of  nonzero 
LDATUM  and  WDATUM  must  be  Included  in  the  value  of  variable  BATH. 

57.  Variables  XIINDX  and  X2INDX  on  the  CHNGBATH  record  specify  the 
minimum  and  maximvim  cell  numbers  in  the  x-direction,  respectively,  where  the 
topography /bathymetry  value  will  change.  Similarly,  variables  YIINDX  and 
Y2INDX  on  the  CHNGBATH  record  specify  the  minimum  and  maximum  cell  numbers  in 
the  y-direction,  respectively,  where  the  topography/bathymetry  value  will 
change.  More  than  one  CHNGBATH  record  is  permitted. 

Wave  conditions 

58.  Each  simulation  requires  wave  information  in  deep  water  (i.e.,  the 
deepwater  wave  height,  direction,  and  period).  The  angle  which  the  offshore 
contour  makes  with  the  grid  y-axis  is  also  needed  (see  Figure  5-4  for  the 
angle  definition/sign  convention) . 

59 .  A  WAVCOND  record  is  required  to  define  each  of  the  deepwater  wave 
conditions  to  be  simulated.  This  information  is  also  used  to  come  up  with  an 
initial  "guess"  for  the  wave  height  and  angle  at  each  point  on  the  computa¬ 
tional  grid  using  Snell's  Law.  One  WAVCOND  record  is  required  for  each  wave 
condition  to  be  simulated,  and  multiple  wave  conditions  are  permitted  for  a 
single  simulation.  Simulations  are  usually  limited,  however,  to  5  to  10  wave 
conditions  grouped  together  in  a  logical  manner.  Diffractive  effects  can  be 
included  or  excluded  for  any  given  simulation  by  specification  on  the  WAVCOND 
record.  Variables  HDEEP,  TDEEP,  and  ZDEEP  specify  the  deepwater  wave  hei^t, 
period,  and  deepwater  wave  angle,  respectively.  Variable  CNTRNG  is  used  to 
define  the  offshore  contour  angle.  The  inclusion  of  topography- induced 
diffractive  effects  is  accomplished  by  setting  DIFFR  equal  to  YES. 

60.  The  WAVMOD  record  is  used  to  explicitly  specify  wave  characteris¬ 
tics  along  the  offshore  boundary.  If  a  WAVMOD  record  is  selected  for  one  wave 
condition  (WAVCOND  record) ,  then  WAVMOD  records  are  required  for  the  remaining 
wave  conditions  in  a  given  simulation.  Variables  HUTILl  and  HUTIL2  are  used 
to  specify  the  wave  height  at  the  first  (J-1)  and  last  (J-YCELLS)  cells  on  the 
offshore  boundary  (I-XCELLS),  respectively.  If  HUTILl  and  HUTIL2  have 
different  values  assigned  to  them,  then  values  of  wave  height  along  the 
offshore  boundary  will  be  linearly  interpolated  between  the  two  specified  end 
values  (HUTILl  and  HUTIL2).  Similarly,  variables  ZUTILl  and  ZUTIL2  are  used 
to  specify  the  wave  angle  at  the  first  (J-1)  and  last  (J-YCELLS)  cells  on  the 
offshore  boundary  (I-XCELLS),  respectively.  If  ZUTILl  and  ZUTIL2  have 


5-25 


different  values  assigned  to  them,  then  values  of  wave  angle  along  the 
offshore  boundary  will  be  linearly  Interpolated  between  the  two  specified  end 
values  (ZUTILl  and  ZUTIL2). 

Convergence  criteria 

61.  Certain  model  parameters  can  be  modified  to  alter  how  quickly  the 
model  converges  toward  a  solution  to  the  governing  equations.  When  the  change 
In  a  given  variable  from  Iteration  to  Iteration  Is  less  than  a  specified 
value,  the  model  has  "converged"  on  a  solution.  The  change  In  the  variable 
from  Iteration  to  iteration  Is  called  the  convergence  criterion.  Variables 
HCONVR  and  SCONVR  on  record  CONVERG  are  convergence  criteria  for  wave  heights 
and  wave  angles,  respectively.  ITAMX  and  IDIFF  are  the  maximum  number  of 
Iterations  for  wave  heights/angles  and  diffraction  computations,  respectively. 
Default  values  for  the  convergence  criteria  have  been  developed  based  on 
experience.  Users  should  not  change  these  values  arbitrarily. 

62 .  Certain  model  parameters  are  used  to  specify  the  stable  wave  height 
and  rate  of  wave  height  decay  through  the  surf  zone.  Variables  STAfiL  and 
DECAY  on  record  CONVERG  are  used  to  set  the  stability  and  decay  coefficients 
used  in  surf  zone  computations.  For  more  information  on  the  selection  of 
these  values,  refer  to  Dally,  Dean,  and  Dalrymple  (1984). 

Output  Specifications 

63.  RCPWAVE  generates  an  output  listing  containing  a  summary  of  the 
Input  data  set  for  every  simulation.  Error  and  warning  diagnostic  messages 
are  also  contained  In  this  listing.  A  sample  output  listing  containing  a 
summary  of  the  Input  dataset  Is  presented  in  Figure  5-8.  Each  record  Is 
summarized  In  tabular  form  with  a  heading  containing  Its  record  Identification 
label  followed  by  a  brief  description  of  that  record's  function.  The  table  Is 
composed  of  each  variable's  name,  a  description  of  that  variable  (including 
Its  units,  when  applicable),  and  an  error  diagnostic  note. 

64.  RCPWAVE  contains  error  diagnostic  features  that  Inspect  an  Input 
data  set  for  possible  errors.  These  features  include:  (a)  comparing  an 
Inputted  value  against  a  range  of  quantities  that  are  representative  for  that 
variable,  (b)  checking  for  misspelled  character  data,  and  (c)  checking  for 
missing  data.  The  error  diagnostic  note  can  be  assigned  one  of  three  charac¬ 
ter  strings,  which  are  (a)  "FATAL"  for  errors  where  the  model  cannot  execute 
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COASTAL  NOOELINC  SYSTEM  (CMS): 


It  C  P  U  A  V  . 


VERSION  1.0 


PLANE  BEACH  EXAMPLE 


GENSPECS  CARO:  SPECIFICATION  OF  TITLE  AW  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLISH 

* 

*****  GRIOSPEC  CARO:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES; 

GRTYK 

XCELL 

OX 

TYPE  OP  FIMITE-DIFFERENCE  GRID 
HUMBER  OF  GRID  CELLS«  X  OIUCTIQN 
SPATIAL  STEPSIZE  IN  X  DIRECTION 

RECTANG 

AB 

10.00 

*  GUNITS 

*  YCELL 

*  DY 

SYSTEM  Of  UNITS  USED  Ktt  TNE  GRID 
HUMKR  OF  GRID  CELLS,  V  DtREaiON 
SPATIAL  STEPS12E  IN  T  DltECTlON 

EIKLISN 

S 

10.00 

*****  PRINTING  OF  FIELD  ARRAY  VARIARUt:  1  AREAS 

AREA  *  STARTING  EWING  STARTING  EWING  *  •  VARIARU  FIELD 

NUMBER  *  X  CELL  X  CELL  T  CELL  Y  CELL  NOTES:  *  START  AT  EW  AT  INTERVAL  NOTES:  *  ARRAYS  TO  PRINT:  NOTES: 

1  *  X«  1  X«  AB  Y*  1  Y*  S  *  *  OAW 


*****  UAVCOW  CARO:  NUMBER  OF  WAVE  COWITIONS;  2 


Figure  5-8.  Sample  output  listing 

given  the  value  supplied,  (b)  "WARN"  for  data  that  are  outside  the  range  of 
values  typically  selected  for  that  variable,  and  (c)  a  null  string  for 
instances  where  an  error  condition  has  not  been  identified.  Although  this 
model  contains  error  diagnostic  capabilities,  the  user  should  thoroughly 
inspect  the  input  data  summary  to  ensure  that  the  data  are  correct. 

65.  Field  arrays  (e.g.,  bathymetry,  wave  heights,  angle,  numbers, 
breaker  indices)  are  printed  along  with  the  input  data  summary  by  including 
one  or  more  PRWINDOU  records.  Variable  UFRVAR  on  record  FRUINDOW  is  used  to 
specify  which  field  arrays  are  to  be  printed  (e.g.  VPRVAR  -  B  for  breaker 
indices).  The  breaker  index  is  a  flag  to  distinguish  cells  where  wave 
breaking  occurs  (indicated  with  a  B) ,  from  cells  where  wave  breaking  does  not 
occur  (indicated  with  a  .).  The  user  can  snecify  printing  of  subgrid  regions 
as  opposed  to  the  entire  grid,  if  they  so  choose.  This  is  done  by  specifying 
the  X-  and  y-boundaries  of  a  subgrid  region  with  variables  WXCELl,  UXCEL2, 
WYCELl,  and  WYCEL2. 
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66.  Plotting  wave  rays  is  facilitated  by  adding  a  PLOTREC  record  to  the 
input  data  set.  With  this  record,  wave  angles  are  saved  for  every  grid  cell 
in  the  computational  domain  for  any  number  of  wave  conditions.  The  wave  angle 
data  are  then  used  by  program  RAYPLOT  in  CMSPOST  to  generate  wave  ray  plots. 

67.  The  SAVESPEC  record  is  used  for  saving  wave  conditions  along  the 
nearshore  reference  line  as  input  to  model  GENESIS  (Cravens,  Kraus,  and  Hanson 
1989) .  Nearshore  wave  data  requirements  of  GENESIS  are  prebreaking  wave 
height  and  angle  and  water  depth  at  each  alongshore  cell  on  the  reference  line 
and  the  associated  wave  period  (which  is  constant  over  the  entire  grid  for  a 
given  RCPWAVE  simulation) .  Input  to  model  RCPWAVE  is  a  SAVESPEC  record 
followed  by  a  l-D  array  containing  the  x-cell  designation  of  the  nearshore 
reference  line  for  each  of  the  y-direction  (alongshore)  cells.  Therefore,  the 
total  number  of  values  entered  is  YCELLS.  Variable  FILOUT  on  the  SAVESPEC 
record  is  used  to  specify  the  output  file  name  for  wave  heights  and  angles 
along  the  nearshore  reference  line. 
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PART  V:  ILLUSTRATIVE  EXAMPLES 


68.  Two  examples  are  Included  in  this  section  to  demonstrate  RCPWAVE's 
capabilities.  The  model  was  used  to  simulate  wave  conditions  at  the  CERC's 
Field  Research  Facility  (FRF)  in  Duck,  North  Carolina,  and  at  Homer  Spit, 
Alaska . 

Duck.  North  Carolina 

69.  The  FRF  is  located  on  the  northern  North  Carolina  coast.  The 
selected  study  area  measured  900  m  in  the  x-  (on-offshore)  direction  and 

l, 200  m  in  the  y-  (longshore)  direction.  The  grid  was. composed  of  75  cells  in 
the  x-direction  and  50  cells  in  the  y-direction,  with  a  cell  size  of  12  by  24 

m,  respectively.  Bathymetry  contours  off  the  Duck,  North  Carolina,  coast  are 
generally  straight  and  parallel  to  the  coastline,  except  in  the  immediate 
vicinity  of  the  FRF  pier  (Figure  5-9).  The  pier's  presence  has  caused  the 
formation  of  a  deep  scour  hole  along  much  of  its  length.  Actual  depth  values 
(relative  to  mean  sea  level  (msl))  were  provided  for  each  cell  in  the  study 
grid.  The  total  water  depth  matrix  was  computed  by  simply  adding  half  of  the 
mean  tide  range  (0.5  m)  to  each  depth  value.  Two  wave  conditions  were  consid¬ 
ered:  (a)  Ho  -  2  m,  T  -  12  sec,  and  -  20  deg  and  (b)  ffo  ”  1*5  m,  T  «• 

8  sec,  and  do  “  *35  deg.  The  input  data  set  is  given  in  Appendix  5-B  for 
details  of  each  record. 


Figure  5-9.  Bathymetric  contours  at 
Duck,  North  Carolina 
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70.  A  wave  ray  plot  for  each  of  the  two  wave  conditions  is  given  in 
Figures  5-10  and  5-11  for  the  entire  computational  domain.  The  wave  rays  tend 
to  diverge  from  the  scour  hole  along  the  pier  and  converge  on  the  adjacent 
shoals,  as  expected.  Model  results  (wave  angles,  heights,  and  breaker  indices 
only)  were  also  printed  (Table  5-3)  for  the  subgrid  region  shown  in  Figure  5- 
9 .  The  breaker  indices  show  wave  breaking  on  the  shoals  and  farther  shoreward 
in  the  vicinity  of  the  pier. 


Figure  5-10.  Wave  rays  for  wave  condition  1 
at  Duck,  North  Carolina 
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Figure  5-11.  Wave  rays  for  wave  condition  2  at  Duck,  North  Carolina 
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Table  5-3 

Output  Summary  for  Duck.  North  Carolina.  Simulation 


COASTAL  MODELING  SYSTEM  (CMS):  ftCPUAV. 


VERSION  1.0 


FIELD  RESEARCH  FACILITY  (DUOC^  NO  EXAMPLE 


GENSPECS  CARO:  SPECIFICATION  OF  TITLE 
VARIABLE  DESCRIPTION  OF  USAGE: 

SUNITS  UNITS  SYSTEM  USED  IN  COMPUTATIONS 


^NO  GENERAL  S'^STEM  CF  UNITS 

V'^'UE:  NOTES:  *  VARIABLE  DESCRIPTION  OF  USAGE: 

METRIC  • 


VALUE:  NOTES: 


*****  GRIOSPEC  CARD:  SPECIFICATION  OF  THE  TYPE  OF  FINIT£*DtFFEREHC£  GRID  USED 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  *  VARIABLE  DESCRIPTION  OF  USAGE: 


VALUE: 


NOTES: 


GRTYPE  TYPE  OF  FINITE-DITFERENCE  GRID  RECTANG 
XCELL  NUMBER  OF  GRID  CELLS,  X  DIRECTION  75 

DX  SPATIAL  STEPSIZE  IN  X  DIRECTION  12.00 


GUNITS  SYSTEM  OF  UNITS  USED  FOR  THE  GRID  METRIC 
YCELL  NUMBER  OF  GRID  CELLS,  Y  DIRECTION  SO 

OY  SPATIAL  STEPSIZE  IN  Y  DIRECTION  24.00 


PRINTING  OF  FIELD  ARRAY  VARIABLES:  1  AREAS 

AREA  *  STARTING  ENDING  STARTING  ENDING  * 

X  CELL  X  CELL  Y  CELL  Y  CELL  NOTES:  *  STMtT  AT  END  AT 


INTERVAL  NOTES: 


X«  1 


50 


Y*  11 


41 


VARIABLE  FIELD 
ARRAYS  TO  PRINT:  NOTES: 


OAHB 


*****  UAVCOND  CARO:  NUMBER  OF  WAVE  CONDITIONS:  2 


BREAKING  INDEX 


J.  4\ 

l«  13 

B 

14 

J>  40 

B 

J*  39 

8 

J>  38 

B 

J.  37 

6 

J*  36 

8 

8 

J*  35 

B 

6 

J<  34 

8 

B 

J-  33 

8 

32 

B 

J.  31 

B 

J<  30 

B 

J*  29 

B 

J*  28 

B 

J.  27 

8 

26 

• 

25 

B 

J>  24 

B 

23 

B 

22 

B 

J.  21 

B 

J«  20 

B 

J«  19 

B 

J.  18 

B 

J.  17 

B 

J*  16 

B 

J*  15 

B 

J«  14 

B 

J*  13 

B 

12 

B 

J.  11 

B 

I*  13  14 


15  16  17 


8 

B 

B 

8 

B 


S 

■ 

15  16  17 


19  20 


18  19  20 


21  22  23 


2’  22  23 
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Homer  Spit.  Alaska 

71.  Homer  Spit  is  a  narrow  peninsula  300  to  1,500  feet  wide,  extending 
approximately  4-1/2  miles  from  northwest  to  southeast  into  Kachemak  Bay,  an 
appendage  of  lower  Cook  Inlet  in  southcentral  Alaska  (Figure  5-12) .  The 
selected  study  area  measured  7.5  miles  in  the  x-  (on-offshore)  direction  and 
13  miles  in  the  y-  (longshore)  direction.  The  grid  was  composed  of  96  cells 
in  the  x-direction  and  83  cells  in  the  y-direction,  with  a  cell  size  of 
416.7  by  833.3  ft.  Bathymetry  in  the  vicinity  of  Homer  Spit  is  complicated 
(Figure  5-13).  Actual  depth  values  (relative  to  mean  lower  low  water  (mllw)) 
were  provided  for  each  cell  in  the  study  grid.  One  wave  condition  was 
considered:  =  S  ft,  T  -  10  sec,  and  6^  -  -45  deg.  The  input  data  set  is 

given  in  Appendix  5-C  for  details  of  each  record. 


72.  A  wave  ray  plot  of  model  results  is  given  in  Figure  5-14  for  the 
entire  grid.  The  wave  rays  bend  towards  the  shoals,  as  expected.  Model 
results  (wave  heights,  angles,  numbers,  and  breaker  indices)  were  also  printed 
for  cells  I-l  to  1=50  and  J=25  to  J-55  (Table  5-4). 
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X-  AXIS 


HOMER  SPIT.  AUSKA  BATHYMETRY 
DEPTHS  ARE  FATHOMS  BELOW  MUW 


Figure  5-13.  Bathymetric  contours  at  Homer  Spit,  Alaska 


Figure  5-14.  Wave  rays  for  wave  condition  1 
at  Homer  Spit,  Alaska 


Table  5-4 


Output  Sununarv  for  Homer  Spit.  Alaska.  Simulation 


COASTAl  MODELING  SYSTEM  {CMS):  NCPWAV,  VERSION  1.0 

-  NOME*  SPIT,  ALASKA  EXAMPLE  - 

•••**  CENSPECS  CARO:  SPECIFICATION  OF  TITLE  ANO  GENERAL  SYSTEM  Of  UNITS 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  *  VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES: 

........  ........  .......  *  ........  ........  ...... 

SUHITS  UNITS  SYSTEM  USED  IN  COMPUTATIONS  ENGLISK  * 


GRIOSPEC  CARO:  SPECIFICATION  OF  THE  TYPE  OF  FINITE-DIFFERENCE  GRID  USED 


VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  *  VARIABLE  DESCRIPTION  OF  USAGE:  VAUC:  MOTES: 

_ _ _  ... _ _ _ _  _ _ _  *  _ _ _  _ ..... _ .......................  ........  ...... 


GRTTPE  TYPE  OF  FINITE-DIFFERENCE  GRID  RECTANG 
XCELL  NUMBER  OF  GRID  CELLS,  X  DIRECTION  96 

OX  SPATIAL  STEPSIZE  IN  X  DIRECTION  ATG.TD 


*  GUNITS  SYSTEM  OF  UNITS  USED  FOR  TNE  GRID  ENCLISM 

*  YCEIL  NUMBER  OF  GRID  CELLS,  Y  DIRECTION  O 

*  OY  SPATIAL  STEPSIZE  IN  Y  DIRECTION  833.30 


printing  of  field  array  VARIABLES:  1  AREAS 


AREA  *  STARTING  ENDING 
NUMBER  *  X  CELL  X  CELL 


STARTING  ENDING  • 

Y  CELL  Y  CELL  NOTES:  *  START  AT  END  AT  INTERVAL  NOTES; 

........  ......  .......  •  ........  ........  ........  ....... 


VMIABU  FIELD 
ARRAYS  TO  PRINT:  NOTES: 


96 


Y» 


T«  83 


*****  UAVCOND  CARO:  NUMBER  OF  IMVE  CONDITIONS:  1 


WAVE  CONDITION  NUMBER:  1 


VARIABLE  OESCRIPTION  OF  USAGE;  VALUE:  NOTES;  *  WRIABLE  DESCRIPTION  OF  USAGE:  MLUE;  NOTES: 

..... _  ......... _ ........... _ .......  ........  .......  *  _ _ ...  ..................................  ........  ...... 

NOEEP  DEEPWATER  WAVE  HEIGHT  8.00  *  TDEEP  WAVE  PERIOD  10.00 

ZOEEP  DEEPWATER  WAVE  ANGLE  -43.00  *  OIFFR  DIFFRACTION  SIMULATED  YES 

CNTRANG  offshore  CONTOUR  ANCLE  0.00  * 


COASTAL  MODELING  SYSTEM  (CMS):  RCPWAV,  VERSION  1.0 


*•**  BATHSPEC  CARO:  SPECIFICATION  OF  BATNYMETRY/TOPOGRAPHY  - 

VARIABLE  DESCRIPTION  OF  USAGE:  VALUE:  NOTES:  *  VARIABLE  OESCRIPTION  OF  USAGE:  VALUE:  NOTES: 

........  ..................................  ........  .......  •  ........  ..................................  ........  ...... 

BUMITS  SYSTEM  OF  UNITS  FOK  DEPTH  DATA 
UDATUN  DATIM  FOR  WATER  DEPTHS 
OLIMIT  MAXIMUM  DEPTH  ALIOUEO 

NUMBER  OF  ELEVATION  CHANGES  •  0 


***  INPUT  PROCESSING  COMPLETED: 

FATAL  ERRORS-  0  WARNINGS  -  0 


FEET 

0.000 

*6000.0 


•SEQ  READ  SEQUENCE  FOR  DEPTH  DECK  YX 
tOATUM  DATIM  FOR  LAND  ELEVATIONS  O.OOO 
BFORM  FORMAT  OF  DEPTH  DATA  (10F8.0) 
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APPENDIX  5 -A:  RCPWAVE  DATA  SPECIFICATION  RECORDS 
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RCPWAVE:  RECOEU)  FUNCTION  INDEX 


(Req)  GENSPECS 


(Req)  GRIDSPEC 


(Req)  BATHSPEC 

(Req) 

(Opt)  CHNGBATH 

(Req)  WAVCOND 

(Opt)  WAVMOD 

(Opt)  CONVERG 


(Req)  PRWINDOW 

(Opt)  PLOTREC 

(Opt)  SAVESPEC 


Model  Control  Specifications 

Specify  general  title  and  system  of  units 

Grid  Description 

Specify  general  grid  characteristics 

Physical  Characteristics 

Specify  characteristics  of  bathymetry/topography 

Two-dimensional  array  of  bathymetric/topo¬ 
graphic  data 

Specify  changes  to  the  bath)rmetric  data 
Specify  deepwater  wave  conditions 
Specify  wave  conditions  on  the  offshore  boundary 
Specify  changes  to  the  convergence  criteria 

Output  Specifications 

Specify  location  of  a  print  window 

Specify  saving  data  for  wave  ray  plot 

Save  wave  conditions  along  the  nearshore 
reference  line 
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CMS  Data  Specification:  GENSPECS  Record:  (Req) 

Purpose:  Specify  general  title  and  system  of  units. 
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CMS  Data  Specification:  GRIDSPEC  Record:  (Req) 
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array  of  bathymetry/topography  val 
Name  of  bathymetry/ topography  svt. 


BATHS PEC  Record  (Concluded) 
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CMS  Data  Specification:  CHNGBATH  Record:  (Opt) 

Purpose:  Specify  changes  to  the  bathymetry  data. 
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CMS  Data  Specification:  WAVMOD  Record:  (Opt) 

Purpose:  Specify  wave  conditions  on  the  offshore  boundary 


CMS  Data  Specification:  CONVERG  Record:  (Opt) 

Purpose:  Specify  changes  to  convergence  criteria 
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f -Continuity 
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Rearranging  the  terns  In  Equations  6-31  through  6-34  yields; 
^-Momentum 


0(-grWg“-||)s;.i,^  +  (1  +  6(FRlO  At)  u;,j  * 

Bi  02  B3 

wheze:  represents  all  known  quantities 


n -Momentum 


+  (1  +  0(FRJC)Ae)V?;j  +  =  B^ 


B, 


f -Continuity 


Ai  A2 


A3 


where:  A4  represents  all  known  quantities 
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Computational  Theory 

36.  The  computational  procedure  used  in  CLHYD  is  based  on  an  Alternat¬ 
ing  Direction  Implicit  (ADI)  scheme  (Roache  1976).  Using  this  method,  the  ^- 
and  f; -momentum  equations  are  solved  separately,  and  each  calculation  in  time 
is  made  in  two  stages  (Figure  6-9).  In  the  first  stage,  the  ^-continuity  and 
^-momentum  equations  are  solved  along  each  row  of  the  grid  to  progress  from 
time  level  n  to  an  intermediate  time  level  *.  The  ^-direction  unit  flow 
rate  components  and  water  surface  fluctuations  are  solved  implicitly,  and  the 
»j-direction  unit  flow  rate  components  are  supplied  from  time  level  n.  The  ^- 
direction  unit  flow  rates  from  this  step  represent  those  at  time  level  n+I  , 
whereas  the  water  surface  fluctuations  are  only  an  approximation  to  those  at 
time  level  n+1  ,  The  »;-direction  unit  flow  rate  components  remain  at  time 
level  n  .  In  the  second  stage,  the  »|-continuity  and  r;-moraentum  equations  are 
solved  along  each  column  for  the  fj-direction  unit  flow  rates  and  the  water 
surface  fluctuations  at  time  level  n+1  .  ^-direction  unit  flow  rate  compo¬ 
nents  are  supplied  from  the  first  stage  calculations. 

37.  As  shown  in  the  finite  difference  approximations  to  the  governing 
equations,  a  weighting  factor,  6  ,  is  used  to  place  the  water  surface  slope 
and  bottom  friction  terms  between  time  levels  n  and  n+2  When  the 
weighting  factor  equals  0.0,  these  terms  are  evaluated  at  the  previous  time 
level  n  (explicit  treatment),  whereas  when  the  weighting  factor  equals  1.0, 
they  are  evaluated  at  the  new  time  level  n+1  (implicit  treatment).  Usually 
a  value  between  0.0  and  1.0  is  used.  Tests  have  shown  that  a  value  of  0.55 
produces  a  stable  solution  with  less  damping  of  the  solution  than  occurs  with 
a  value  of  1.0. 
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CHAPTER  8 


STWAVE  THEORY  AND  PROGRAM  DOCUMENTATION 

PART  I :  INTRODUCTION 


1.  The  STWAVE  program  in  the  Coastal  Modeling  System  (CMS)  is  a 
computationally  efficient  finite -difference  model  for  near-coast  time- 
independent  spectral  wave  energy  propagation  simulations.  The  program  was 
developed  by  Dr.  Donald  T.  Resio  of  Ocean  and  Coastal  Technology,  Inc.,  and 
was  implemented  in  the  CMS  by  the  Coastal  Engineering  Research  Center  (CERC) 
at  the  US  Army  Engineer  Waterways  Experiment  Station.  The  efficiency  of  the 
program  is  due  to  the  assumption  that  only  wave  energy  directed  into  the 
computational  grid  is  significant,  i.e.,  wave  energy  not  directed  into  the 
grid  is  neglected.  The  program  also  assumes  that  wave  conditions  vary  slowly 
enough  that  the  variation  of  waves  at  a  given  point  over  time  may  be  neglected 
relative  to  the  time  required  for  waves  to  pass  across  the  computational  grid. 
While  these  assumptions  minimize  computations,  they  also  limit  the  model  to 
near-coast  applications  in  which  waves  are  generally  directed  into  the  grid 
and  move  quickly  across  it  (within  30  min) . 

2.  The  following  sections  briefly  describe  the  theoretical  background 
of  STWAVE.  Also,  the  operations  of  the  STWAVE  portion  of  the  CMS  Spectral 
Wave  Modeling  module  are  described,  including  the  structure  of  the  module, 
organizational  procedures  for  an  STWAVE  simulation,  and  the  required  data  for 
a  successful  STWAVE  simulation. 


Theoretical  Foundation 


3.  STWAVE  is  based  on  a  simplified  form  of  the  following  spectral 
balance  equation  where  it  is  noted  that  the  variables  are  functions  of  space 
and  time  although  not  explicitly  written  as  such: 


dE(f,6)  ^  dcCgEjf.Q)  ^  dcCgSjf.B) 


dt 


dx 


dy 


S.t  * 


Sd.  + 


+  S, 


'bt 


(8-1) 


where 


E  -  spectral  energy  density 
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f  “  frequency  of  spectral  component 
6  -  propagation  direction  of  spectral  component 
t  -  time 

c  —  phase  speed  of  spectral  component 
Cg  —  group  velocity  of  spectral  component 
x,y  -  plan-view  spatial  coordinates 

S  -  energy  source/sink  quantity  described  below 
The  first  term  on  the  left-hand  side  (LHS)  of  Equation  8-1  is  the  rate  of 
change  of  a  spectral  energy  component  with  respect  to  time  for  a  given 
location.  The  second  and  third  terms  on  the  LHS  of  Equation  8-1  represent  the 
advection  of  a  spectral  energy  component.  The  remaining  source/sink  terms  on 
the  right-hand  side  of  Equation  8-1  represent  physical  mechanisms  that  add  to, 
or  subtract  from,  energy  in  the  wave  field.  The  source/sink  terms,  in  order 
from  left  to  right  are  the  atmospheric  energy  input,  nonlinear  wave-wave 
interactions,  wave  energy  dissipation  within  the  wave  field  (e.g.,  white 
capping),  energy  dissipation  due  to  wave-bottom  interactions,  and  surf-zone 
breaking . 

U.  Under  the  assumption  that  the  simulated  waves  are  independent  of 
time,  the  first  term  on  the  LHS  of  Equation  8-1  is  zero.  Additionally,  since 
the  implementation  of  STWAVE  in  CMS  is  for  wave  propagation  only,  it  neglects 
wind-wave  generation,  nonlinear  energy  transfer,  and  wave  field  and  wave- 
bottom  dissipation.  Therefore,  all  of  the  source  terms  in  Equation  8-1  are 
zero,  except  for  S^r.  which  accounts  for  surf- zone  breaking  of  the  wave -energy 
spectrum.  Equation  8-1  may  then  be  reduced  to: 


dx 


^(f,9) 

dy 


Str  =  0 


(8-2) 
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Solution  Method 


6.  All  STWAVE  simulations  require  a  wave  energy  spectrum  specified  for 
the  input  boundary  of  the  computational  grid.  STWAVE  then  transforms  that 
spectrum  across  the  grid.  Considering  the  computational  grid  presented  in 
Figure  8-1,  the  spectrum  is  transformed  from  one  column  to  the  next  starting 
at  the  input  boundary.  The  transformation  of  each  spectral  component  includes 
refraction  and  shoaling  effects.  Each  spectral  component  along  a  given  column 
is  then  modified  to  include  the  effects  of  bottom  diffraction  and  the 
convergence/divergence  of  energy  within  the  spectrum  influenced  by  the  local 
bathymetry.  When  the  propagation  of  the  entire  spectrum  to  the  new  column  is 
complete,  it  is  evaluated  for  breaking  conditions.  When  a  spectrum  is 
considered  breaking,  the  energy  levels  within  the  spectrvun  are  limited  to 
level.,  defined  by  Davis,  Smith,  and  Vincent  (1991).  The  spectra  along  the  new 
column  are  then  propagated  to  the  next  column.  When  a  land  point  within  the 


-90’ 


270* 


Figure  8-1.  Orientation  and  coordinate  systems  for  an  STWAVE  simulation 
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grid  is  encountered,  the  total  spectral  energy  for  that  point  is  set  to  zero. 
Also,  the  energy  levels  for  spectra  on  the  boundaries  of  the  grid  are  set  to 
the  values  of  the  spectra  on  the  rows  or  columns  adjacent  to  the  boundaries. 

7.  The  user  is  provided  with  great  flexibility  in  specifying  the  input 
boundary  spectrum.  Note  that  the  input  boundary  spectrum  is  applied  to  all 
points  on  the  boundary  except  land  points  that  are  assigned  zero  spectral 
energy  values .  The  STWAVE  module  can  be  used  to  generate  an  input  boundary 
spectrum  from  a  given  total  energy-based  wave  height,  peak  spectral  period, 
and  mean  spectral  propagation  direction.  Based  on  these  wave  characteristics, 
a  JONSWAP/TMA  spectrum  (Bouws  et  al.  1985)  is  generated  with  a  symmetric 
directional  distribution.  The  user  specifies  the  amount  of  directional  spread 
of  energy  within  the  spectrxjim,  which  may  range  from  unidirectional  to 
extremely  wide  spread  in  direction.  The  user  may  also  specify  the  input 
boundary  spectrum  by  entering  the  JONSWAP/TMA  spectral  parameters  directly,  by 
entering  the  complete  frequency  spectrum,  or  by  entering  the  complete 
frequency-direction  spectrum. 

8.  The  input  boundary  condition  spectra  may  be  provided  as  a  single 
spectrum  or  as  a  series  of  spectra  for  a  given  STWAVE  simulation.  For 
example,  if  several  design  wave  conditions  are  to  be  evaluated  by  the  user, 
all  of  the  design  conditions  may  be  simulated  during  a  single  STWAVE  run.  The 
ability  to  enter  multiple  wave  conditions  during  a  single  SIWAVE  execution 
also  allows  the  user  to  represent  a  time -dependent  simulation  by  modeling  a 
series  of  time -independent  wave  conditions  in  sequence.  By  the  inherent 
assiimptions  in  STWAVE,  each  wave  condition  simulated  is  independent  of  time, 
but  the  variation  from  one  simulated  wave  condition  to  the  next  could 
represent  the  variation  of  wave  conditions  over  time. 

9 .  Another  method  available  in  the  STWAVE  module  for  specifying  input 
boundary  conditions  is  through  a  subgrid  simulation  for  a  preceding  SHALWV 
simulation.  The  STWAVE  module  is  designed  to  easily  incorporate  wave  energy 
spectra  saved  from  a  previous  SHALWV  run  at  the  location  of  the  input  boundary 
of  the  STWAVE  simulation.  Hence,  a  record  of  wave  spectra  may  be  simulated 
during  a  single  STWAVE  simulation.  Each  input  spectrum  within  the  STWAVE 
simulation  would  be  independent  of  time,  but  the  simulation  of  the  sequence  of 
spectra  would  represent  the  time -variation  of  the  spectra.  This  approach  is 
only  valid  when  the  computational  grid  is  small,  such  that  the  smallest 
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spectra  in  the  record  can  propagate  across  the  grid  quickly;  for  example,  in 
less  than  30  min.  If  the  grid  is  too  large,  then  the  subgrid  simulation 
should  be  conducted  with  the  subgrid  option  within  the  SHALWV  module 
(Chapter  7) . 
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PART  II:  STRUCTURE  OF  THE  SPECTRAL  WAVE  MODELING  MODULE 

Introduction:  Operational  Structure  of  the  STWAVE  Branch 

10.  The  operational  functions  of  the  STWAVE  branch  of  the  Spectral  Wave 
Modeling  module  are  illustrated  in  Figure  8-2.  In  general,  the  file -building 
function  must  be  used  prior  to  the  function  to  run  programs,  and  the  function 
to  run  programs  must  be  used  prior  to  the  function  to  post-process  the  model 
results.  Figures  8-3  through  8-5  indicate  the  coordination  between  files 
created  and  used  by  each  routine  within  each  function  of  the  STWAVE  module. 

The  coordination  between  the  functions  and  the  routines  within  each  function 
can  be  followed  by  observing  which  routines  create  files,  and  which  routines 
use  those  files.  Each  file  has  an  associated  letter  and  number.  Files  that 
are  required  for  input  are  identified  with  the  letter  "R."  Files  that  are 
automatically  created  by  routines  are  identified  with  the  letter  ”A,"  and 
files  that  are  optionally  created  or  required  by  routines  are  identified  with 
the  letter  "0."  The  contents  and  format  of  data  within  each  file  are 
described  in  Part  IV,  Spectral  Wave  Modeling  Module  File  Descriptions. 

Organizational  Procedures  for  Common  Simulations 

11.  The  organizational  procedures  for  common  types  of  simulations  are 
presented  below: 

Simulation  #1:  Simulate  the  transformation  of  a  wave  energy  spectrum  across 

a  region  of  interest,  but  not  as  a  subgrid  computation  for  a 
previous  SHALWV  run. 

Procedure :  Run  General  File-Building  Routine. 

Run  Boundary  Condition  File-Building  Routine. 

Run  Boundary  Condition  Generator  (BCGEN)  program. 

Run  STWAVE. 

Notes :  The  General  File-Building  Routine  allows  the  user  to  specify 

characteristics  of  the  computational  grid,  discretization  of 
the  wave  energy  spectrum,  number  of  wave  conditions  that 
will  be  simulated,  and  specific  locations  at  which  model 
results  should  be  output.  The  Boundary  Condition  File- 
Building  Routine  allows  the  user  to  specify  the  type  of  wave 
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Figure  8-2.  Organization  of  functions  and  routines  within  the  STWAVE  branch 

of  the  Spectral  Wave  Modeling  Module 


conditions  to  simulate.  The  BCGEN  program  is  run  to 
generate  the  input  boundary  condition  spectrum  for  the 
STWAVE  simulation,  and  STWAVE  is  run  to  compute  the 
transformation  of  those  input  spectral  wave  conditions 
across  the  region  of  interest  (computational  grid) . 

Simulation  #2:  Simulate  the  transformation  of  a  wave  energy  spectrvun  across 

a  region  of  interest  as  a  subgrid  computation  for  a  previous 
SHALWV  run. 

Procedure :  Run  General  File-Building  Routine. 

Run  STWAVE. 

The  General  File-Building  Routine  is  used  as  described  in 
Simulation  #1.  However,  the  boundary  condition  data  saved 
from  the  previous  SHALWV  run  are  formatted  by  the  General 
File-Building  Routine  for  the  subsequent  STWAVE  subgrid  run. 
STWAVE  is  then  run  to  compute  the  transformation  of  those 
input  spectral  wave  conditions  across  the  subgrid. 
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Figure  8-3.  File-Building  Function 


RUN  PROGRAMS  FUNCTION 


FILE  * 


O  H  (M 
•H  rS 


Figure  8-4.  Run  Programs  Function 
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PART  III:  MODULE  FUNCTIONS  AND  ROUTINES 


STWAVE  Module  Functions  and  Routines 

12.  The  first  function  of  the  STWAVE  branch  of  the  Spectral  Wave 
Modeling  module  of  CMS  is  to  build  most  or  all  of  the  necessary  input  files 
for  the  user's  application.  The  second  function  is  to  run  the  BCGEN  and 
STWAVE  programs .  The  third  function  is  to  display  graphically  or 
statistically  the  results  of  the  user's  most  recent  STWAVE  run.  Descriptions 
of  the  operation  of  each  function  and  routine,  and  the  specific  information 
required  by  each  function  and  routine,  are  presented  in  the  following 
sections . 


File-Building  Functions 

13.  The  first  function  of  the  STWAVE  module  is  to  assist  users  in 
building  the  input  files  required  by  STWAVE.  Users  are  prompted  for  input 
through  a  series  of  menu  selections  and  quest ion -answer  sessions.  It  is 
recommended  that  the  file-building  function  routines  be  used  at  all  times  to 
organize  data  and  files  for  an  STWAVE  run.  This  will  minimize  potential  file 
format  and  organization  errors.  Note,  however,  that  some  files  may  be  easier 
to  build  on  a  word  processor  (e.g.,  large  bathymetry  files).  For  such  cases, 
the  proper  data  definitions  and  data  formats  for  the  files  may  be  found  in 
Part  IV,  Spectral  Wave  Modeling  Module  File  Descriptions. 

14.  Two  routines  can  be  used  to  build  the  necessary  input  files  for 
STWAVE.  The  first  is  the  General  File-Building  Routine  which  builds  up  to 
five  of  the  input  files  required  for  an  STWAVE  run.  The  second  file-building 
routine  is  called  the  Boundary  Condition  File-Building  Routine,  which 
constructs  the  BCGEN  input  file.  (The  BCGEN  program  generates  boundary 
conditions  for  STWAVE.) 

General  File-Building  Routine 

15.  The  General  File-Building  Routine  is  used  to  construct  the  required 
General  Input  File,  Bathymetry  File,  Parameter  File,  Main  File  Name  File,  and 
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optionally,  the  Boundary  Condition  File.  The  General  Input  File  contains  the 
following  information: 

a.  Program  flow  control  parameters. 

b.  Discretization  specifications  for  the  wave  energy  spectra. 

c.  Computational  grid  specifications. 

d.  Specifications  of  locations  at  which  model  results  are 
desired. 

16.  The  Bathymetry  File  contains  a  water  depth  for  each  node  in  the 
computational  grid.  The  user  may  build  the  Bath3rmetry  File  interactively 
through  the  General  File-Building  Routine,  in  which  case  the  user  is  prompted 
for  a  water  depth  at  each  node,  or,  when  water  depth  is  constant,  the  user  is 
prompted  for  the  constant  depth  value.  The  user  may  also  build  the  Bathymetry 
File  with  another  editor  (word  processor),  transfer  it  to  the  user's  CRAY  Y-MP 
account,  and  then  specify  the  name  of  the  file  during  the  General  File- 
Building  Routine.  In  such  a  case,  since  the  Bathymetry  File  already  exists, 
the  General  File-Building  Routine  will  simply  record  the  name  of  the  file  for 
later  use  by  STWAVE. 

17 .  The  Boundary  Condition  File  is  used  by  STWAVE  for  input  boundary 
conditions.  The  only  instance  in  which  the  General  File-Building  Routine 
creates  this  file  is  when  STWAVE  is  being  run  as  a  subgrid  of  a  previous 
SHALWV  run.  In  such  cases,  the  boundary  condition  data  saved  by  SHALWV  at  the 
boundary  of  the  STWAVE  grid  are  read  by  the  General  File -Building  Routine  and 
processed  appropriately  for  the  subsequent  STWAVE  run.  In  essence,  the 
General  File-Building  Routine  eliminates  the  portion  of  the  wave  energy 
spectrum  that  is  not  directed  into  the  STWAVE  grid.  Figure  8-6  illustrates 
this  "spectral  energy  filtering"  process.  The  processed  (filtered)  spectra 
are  then  written  to  the  Boundary  Condition  File  for  input  to  STWAVE. 

Data  descriptions  for  General  File-Building  Routine 

18.  Descriptions  of  the  data  requested  by  the  General  File-Building 
Routine  are  provided  below.  The  descriptions  have  the  following  format;  the 
prompts  that  the  user  will  see  during  the  interactive  General  File -Building 
session  are  provided  by  "Question;"  as  they  would  appear  on  the  user's 
terminal  during  the  interactive  file-building  session,  along  with  an 
identifying  number  for  reference  (e.g.,  GF-1,  which  stands  for  General  file- 
Building  question  number  1).  A  list  of  "Options:"  is  provided,  which  may  be 
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Figure  8-6.  Spectral  energy  from  a  preceding  SHALWV  simulation  is  truncated 
for  a  subsequent  STWAVE  subgrid  simulation 
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used  to  answer  the  question.  If  the  question  requires  a  limited  response, 
then  the  permitted  range  of  values  is  given.  A  list  of  previous  questions  and 
their  corresponding  answers  that  determine  whether  the  current  question  is 
asked  are  presented  under  "Preselect;."  For  example,  question  GF-8  will  not 
be  asked  unless  the  user  previously  selected  option  1  for  question  GF-2.  Each 
question  is  explained  under  the  "Define:"  section,  and  a  "Caution."  is 
provided  when  appropriate  to  alert  users  to  special  requirements  of  the 
module.  When  necessary,  a  "PATH;"  is  provided,  which  indicates  the  next 
question  based  on  the  user's  answers  to  previous  questions.  While  all  of  the 
questions  that  could  be  asked  by  the  module  are  listed  below,  no  one 
simulation  will  ever  require  answers  to  all  of  the  questions. 


GF-1  Question  ; 
Options  : 

Preselect : 
Define  : 


Caution 


GF-2  Question  : 
Options  : 

Preselect : 
Define  : 


Caution 


Enter  SCREEN  WIDTH  OPTION  > 

1-80  Characters. 

2  -  132  Characters. 

None. 

The  setup  for  the  display  width  of  the  user's  screen  is 
necessary  to  keep  matrices  from  "wrapping"  around  on  the 
screen  or  from  being  truncated  on  the  screen  during  the 
review  of  data  at  the  terminal  following  the  General  File- 
fiuilding  Routine. 

If  the  user  selects  a  132-character  screen  width  when  the 
screen  is  only  80  characters,  matrices  displayed  during  the 
data  review  at  the  end  of  the  General  File-Building  session 
will  be  "wrapped"  around  on  the  screen  or  truncated  by  the 
edge  of  the  screen.  This  will  only  affect  data  viewing  and 
not  the  data  itself. 

Enter  the  SUB -GRID  OPTION  > 

1  -  No  subgrid. 

2  -  Subgrid  to  SHALWV  run. 

None . 

If  this  STWAVE  simulation  is  intended  to  be  a  subgrid 
simulation  for  a  previous  SHALWV  simulation,  then  the  user 
selects  option  2.  If  not,  the  user  selects  option  1.  See 
the  discussion  in  Part  II,  Structure  of  the  Spectral  Wave 
Modeling  Module,  regarding  subgrid  simulations  for  preceding 
SHALWV  simulations. 

A  subgrid  simulation  requires  that  the  General  Input  File 
and  the  Subgrid  Boundary  Condition  File  exist  from  the 
preceding  SHALWV  simulation.  Both  files  are  automatically 
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retrieved  during  the  General  File-Building  session  for 
STWAVE  and  are  used  to  reformat  the  Boundary  Condition  File 
for  the  subsequent  STWAVE  subgrid  simulation.  The  user  may 
be  unaware  of  many  of  the  files  that  are  being  built  and 
used  by  SHALWV  and  STWAVE,  and  therefore,  he  may  not  know 
whether  the  required  files  from  the  original  SHALWV 
simulation  exist.  However,  if  prior  to  this  subgrid 
simulation  the  user  specified  that  the  output  boundary 
conditions  be  saved  during  the  original  SHALWV  simulation, 
and  he  conducted  no  other  simulations  in  between,  and  if  the 
user  did  not  delete  or  remove  any  files  from  his  directory, 
then  he  can  be  assured  that  the  necessary  files  exist. 

GF-3  Question  ;  Enter  nximber  of  COLUMNS  In  Grid  > 

Options  :  Range  3  -  200. 

Preselect:  None. 

Define  Figure  8-1  defines  the  columns  of  the  computational  grid. 

Caution  None. 

GF-4  Question  :  Enter  number  of  ROWS  In  the  Grid  > 

Options  :  Range  3  -  200. 

Preselect:  None. 

Define  Figure  8-1  defines  the  rows  of  the  computational  grid. 

Caution  ;  None . 

GF-5  Question  :  Enter  CELL-SIZE  OF  COLUMNS  (a)  > 

Options  :  >0. 

Preselect:  None, 

Define  The  user  must  input  the  cell  width  of  a  column  of  the  grid. 

Caution  Units  must  be  in  meters  (m) . 

GF-6  Question  :  Enter  CELL-SIZE  OF  ROW  (a)  > 

Options  >0. 

Preselect:  None. 

Define  The  user  must  input  the  cell  width  of  a  row  of  the  grid. 

Caution  Units  must  be  in  meters  (m) . 

GF-7  Question  :  Enter  ROTATION  ANGLE  FOR  GRID  (deg)  > 

Options  0  <  ROTATION  ANGLE  <  360. 

Preselect:  None. 

Define  All  calculations  performed  by  STWAVE  are  referenced  to  the 

STWAVE  grid.  That  is,  the  reference  frame  for  the  program 
is  attached  to  the  grid  and  not  the  real  world.  To  relate  a 
Cartesian  reference  to  input  and  output  for  STWAVE,  the 
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rotation  of  the  grid  relative  to  the  Cartesian  system  shown 
in  Figure  8-1  must  be  given.  A  counterclockwise  rotation  of 
the  STWAVE  grid  is  positive.  A  clockwise  rotation  is 
negative . 

Caution  Units  must  be  in  degrees  (deg)  using  the  Cartesian  reference 
system  shown  in  Figure  8-1. 

PATH:  o  IF  SUBGRID  SIMULATION  (Option  2,  question  GF-2).  GO  TO 

QUESTION  GF-11. 

GF-8  Question  :  Enter  number  of  FREQUENCY  BANDS  > 

Options  Range  5-20. 

Preselect:  GF-2,  option  1. 

Define  :  A  wave  energy  spectrum  is  defined  over  frequency  and 

direction.  Although  a  wave  energy  spectrum  is  actually  a 
continuum,  the  spectrum  can  only  be  represented  numerically 
by  discretizing  it  over  frequency  and  direction.  The  user 
must  select  the  number  of  frequency  bands  with  which  to 
discretize  the  wave  energy  spectrum. 

Caution  :  A  value  of  20  frequency  bands  is  recommended.  Both  the 
spectral  resolution  and  simulation  computation  time  vary 
directly  with  the  number  of  frequency  bands. 

GF-9  Question  :  Enter  the  FIRST  FREQUENCY  BAND  VALUE  (Hz)  > 

Options  :  >0. 

Preselect;  GF-2,  option  1. 

Define  :  The  user  must  provide  a  starting  frequency  value  to  which 
the  module  will  add  frequency  increments  to  derive  all  of 
the  frequency  band  values.  (The  size  of  the  frequency 
increment  is  specified  in  question  GF-10.) 

The  user  should  provide  for  a  range  of  frequency  values  that 
span  the  expected  range  of  frequencies  that  contain 
significant  wave  energy  for  the  simulation.  A  reasonable 
range  of  values  is  from  one -fourth  to  four  times  the  peak 
frequency  (inverse  of  the  peak  spectral  period).  For 
example,  if  the  spectral  wave  conditions  to  be  simulated  by 
STWAVE  have  a  peak  period  of  10  sec ,  then  the  peak  frequency 
would  be  0.1  Hz.  The  recommended  frequency  band  values 
should  then  range  between  0.025  and  0.4  Hz.  Therefore,  the 
first  frequency  band  value  would  be  0.025  Hz. 

Caution  :  First  frequency  band  value  must  be  greater  than  zero.  Units 
must  be  in  Hertz  (Hz). 

GF-10  Question  :  Enter  the  FREQUENCY  BAND  INTERVAL  (Hz)  > 

Options  >0. 

Preselect;  GF-2,  option  1. 
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Define 


Caution 

GF-11  Question 
Options 
Preselect 
Define 


Caution 

GF-12  Question  : 
Options 
Preselect: 
Define 

Caution 

GF-13  Question  : 
Options 

Preselect: 


The  user  must  provide  the  frequency  increment  value  for 
computing  the  frequency  band  values.  The  Increment  value  is 
cumulatively  added  to  the  first  frequency  value  specified  in 
question  GF-9.  The  Increment  value  must  be  such  that  when 
it  is  added  to  the  first  frequency  value,  the  resulting 
frequency  band  values  will  cover  the  necessary  range  of 
frequencies.  For  the  example  given  in  question  GF-9, 
assuming  20  frequency  bands  were  specified  in  question  GF-8, 
the  increment  needed  is  about  0.02  Hz  to  get  20  equally 
spaced  frequency  bands  between  0.025  and  0.4  Hz. 

Units  must  be  in  Hertz  (Hz). 

Enter  the  nuaber  of  ANGLE  BANDS  > 

Range  5-36. 

None . 

This  is  the  same  as  question  GF-8,  except  that  direction 
bands  are  considered  instead  of  frequency  bands.  The 
directional  bands  encompass  a  180°  arc,  less  two  small 
extreme  angle  bands,  which  are  described  in  question  GF-12. 
The  equation  to  determine  the  size  of  each  angle  band  is 

«=(180°-2€)/{N,-l)  (8-4) 

where 

6  spectral  angle  band  width 

€  »•  spectral  angle  band  width  excluded  at  edge  of  the 

180°  arc  (see  question  GF-12) 

N,  •  number  of  angle  bands 

For  example,  if  c  is  5°  and  N,  Is  18,  then  6  is  10°. 

A  value  of  18  frequency  bands  Is  recommended  for  most 
simulations.  Both  the  spectral  resolution  and  simulation 
computation  time  vary  as  the  number  of  angle  bands. 

Enter  the  size  of  EXTREME  ANGLE  EXCLUSION  (deg)  > 

>  0. 

None. 

The  extreme  angle  exclusion  should  be  approximately  one -half 
the  width  of  an  angle  band  as  defined  by  Equation  8-4. 

None . 

Enter  WATER  DEPTH  INPUT  OPTION  > 

1  -  Spatially  constant  water  depth. 

2  -  Spatially  variable  water  depth. 

None . 
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Define 


Caution 
GF-14  Question 
Options 
Preselect 
Define 


Caution 


PATH:  o 

GF-15  Question  : 
Options  : 

Preselect: 

Define 


Caution 
PATH:  o 

GF-16  Question 
Options 
Preselect 


The  bathymetry  of  the  model  area  may  be  specified  either  as 
constant  or  variable.  If  constant  depth  is  selected,  the 
user  will  be  prompted  for  the  depth  to  be  used  for  all 
points  on  the  computational  grid.  If  variable  depth  is 
selected,  the  user  will  have  the  option  to  input  the  depth 
data  interactively,  or  through  a  file,  for  every  point  on 
the  computational  grid. 

None . 

Enter  DEPTH  CONVERSION  FACTOR  > 

Variable. 

None . 

The  depths  that  STWAVE  uses  must  be  in  units  of  meters  with 
positive  values  Indicating  depth  below  mean  sea  level.  A 
conversion  factor  must  be  entered,  which  allows  STWAVE  to 
convert  depth  Information  to  meters.  For  example,  if  depth 
data  are  given  in  feet,  then  a  conversion  factor  of  0,3048 
(m/ft)  must  be  entered. 

If  bathymetry  data  are  given  in  meters,  the  user  enters  a 
value  of  1.0  as  a  conversion  factor.  Note:  if  bathymetry 
data  are  provided  such  that  negative  values  indicate  depths 
below  a  mean  sea  level,  then  a  negative  depth  conversion 
factor  will  convert  those  values  to  the  positive  values  that 
are  required  by  STWAVE.  Depth  values  of  zero  are  considered 
land. 

IF  WATER  DEPTHS  ARE  CONSTANT  (Option  1,  question  GF-13),  GO 
TO  GF-19. 

Are  WATER  DEPTHS  in  a  file?  (yes  or  no)  > 

y  (or  Y)  -  water  depths  are  in  a  file. 

n  (or  N)  -  water  depths  will  be  entered  interactively. 

GF-13,  option  2. 

Water  depths  may  be  entered  from  a  file.  If  water  depths 
are  entered  from  a  file,  then  the  user  is  prompted  for  the 
file  name.  If  water  depths  are  not  entered  from  a  file,  the 
user  must  enter  them  interactively  during  the  General  File- 
Building  session.  Water  depth  values  are  required  for  each 
point  on  the  computational  grid. 

None . 

IF  NO  WATER  DEPTH  FILE  (Option  'no',  question  GF-15),  GO  TO 
GF-17. 

Enter  the  WATER  DEPTH  FILE  name  > 

Variable . 

GF-13,  option  2;  GF-15,  option  "yes." 
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Define  The  water  depth  file  contains  the  water  depth  values  for 

each  point  in  the  computational  grid.  The  format  for  the 
Bathymetry  File  is  provided  in  Part  IV,  Spectral  Wave 
Modeling  Module  File  Descriptions.  Figure  8-1  shows  the 
orientation  of  the  grid  and  the  corresponding  orientation  of 
the  water  depth  data.  Water  depths  must  be  entered  as 
positive  numbers,  while  land  points  are  zero. 

Caution  The  water  depth  file  name  must  conform  to  the  file-naming 

conventions  of  the  UNIX  operating  system  (only  the  first  14 
characters  are  significant) .  The  units  of  the  water  depth 
data  must  be  consistent  with  the  conversion  factor  entered 
in  question  GF-14.  The  number  of  depth  data  values  must  be 
identical  to  the  number  of  grid  points  (questions  GF-3  and 
GF-4) . 

PATH:  o  IF  WATER  DEPTH  FILE  (Option  'yes',  question  GF-15),  GO  TO 

GF-20. 

GF-17  Question  :  Build  the  water  depth  file?  (yes  or  no)  > 

Options  y  (or  Y)  -  water  depth  values  entered  interactively. 

n  (or  N)  -  water  depth  values  not  entered  interactively. 

Preselect;  GF-13,  option  2;  GF-15,  option  "no." 

Define  The  user  indicates  whether  he  is  ready  to  begin  building  the 

water  depth  file.  If  he  Indicates  yes,  the  module  will 
prompt  him  for  water  depth  values  for  each  point  on  the 
computational  grid. 

Caution  If  the  user  Indicates  that  the  water  depth  file  will  not  be 
built  Interactively,  then  the  General  File-Building  session 
will  end,  and  no  Information  will  be  saved.  The  user  will 
be  required  to  rerun  the  General  File-Building  Routine. 

GF-18  Question  :  Enter  the  WATER  DEPTH  MATRIX  > 

Enter  the  value  for  ROW  »  ##,  COL  ##; 

Options  Variable. 

Preselect:  GF-13,  option  2;  GF-15,  option  "no";  GF-17,  option  "yes." 

Define  The  user  begins  entering  the  water  depth  values  for  the 

specified  grid  points.  Figure  8-1  shows  the  orientation  of 
the  grid  and  the  corresponding  orientation  of  the  water 
depth  data.  While  building  the  water  depth  file,  the  user 
should  keep  in  mind  that  land  should  be  identified  by  a 
value  equal  to  zero  (0.0). 

Caution  The  water  depth  values  must  be  consistent  with  the  depth 
conversion  factor  entered  in  question  GF-14. 

PATH:  o  IF  VARIABLE  WATER  DEPTHS  (Option  2,  question  GF-13),  GO  TO  GF-20. 

GF-19  Question  ;  Enter  CONSTANT  WATER  DEPTH  > 

Options  >0. 
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Preselect;  GF-13,  option  1. 

Define  :  Enter  the  single  water  depth  value  to  be  used  for  all  points 
on  the  computational  grid. 

Caution  The  depth  value  must  be  consistent  with  the  depth  conversion 
factor  entered  in  question  GF-14. 

GF-20  Question  ;  Enter  NUMBER  OF  HOURS  BETWEEN  INPUT  CONDITIONS  > 

Options  >  1 . 

Preselect:  GF-2,  option  1. 

Define  :  If  input  boundary  conditions  are  intended  to  represent  the 

time  variation  of  wave  conditions,  the  user  must  specify  the 
number  of  hours  represented  by  each  input  condition.  If 
input  boundary  conditions  are  unrelated  to  one  another,  for 
example,  a  series  of  design  wave  conditions,  the  user  enters 
"1."  The  answer  to  this  question  does  not  influence  the 
simulation,  it  is  simply  used  to  increment  time  during  the 
simulation. 

Caution  :  None . 

GF-21  Question  :  Enter  NUMBER  OF  INPUT  CONDITIONS  > 

Options  ;  >1. 

Preselect;  GF-2,  option  1. 

Define  :  The  user  enters  the  number  of  input  data  sets  (boundary 

conditions)  that  will  be  simulated  during  this  STWAVE  run. 

Caution  ;  None . 

GF-22  Question  :  Enter  NUMBER  OF  OUTPUT  LOCATIONS  > 

Options  Range  0  -  100 . 

Preselect;  None. 

Define  The  output  locations  are  those  points  on  the  computational 

grid  at  which  model  results  should  be  saved  to  files.  The 
model  results  saved  include  the  energy-based  wave  height, 
peak  spectral  period,  mean  spectral  propagation  direction, 
and  both  the  one-dimensional  (frequency)  and  two-dimensional 
(frequency- direction)  spectra. 

Caution  :  If  the  user  selects  0,  no  data  will  be  saved  from  the  STWAVE 
run  except  wave  field  data  (energy-based  wave  heights,  peak 
spectral  periods,  and  mean  spectral  propagation  directions 
for  each  node,  for  each  input  condition).  If  the  user 
selects  a  value  between  1  and  100,  he  will  be  prompted  for 
the  ROW  and  COLUMN  values  for  each  output  location  in 
question  GF-23. 

PATH:  o  IF  NO  SPECIAL  OUTPUT  LOCATIONS  (answer  0,  question  GF-21), 

END  THE  FILE-BUILDING  SESSION. 


8-20 


GF-23  Question  : 

Options 
Preselect : 
Define 

Caution  : 
PATH :  o 


Enter  the  OUTPUT  LOCATIONS  (COLUMN  and  ROW)  > 

COLUMN  and  ROV  for  point  ###: 

Variable . 

GF-22,  0  <  VALUE  <  100. 

The  column  and  row  values  must  conform  to  the  orientation  of 
the  grid  as  defined  in  Figure  8-1. 

Separate  the  entered  values  with  a  comma  ( , )  or  a  space  (  ) . 
END  GENERAL  FILE-BUILDING  SESSION. 


Boundary  Condition  File-Building  Routine 

19.  The  user  must  provide  an  input  wave-energy  spectrtun  (called  a 
boundary  condition)  for  any  STWAVS  simulation.  This  boundary  condition 
spectrum  may  be  specified  in  several  ways.  One  method  for  generating  the 
input  boundary  condition  spectrum  is  by  specifying  the  energy-based  wave 
height,  peak  spectral  period,  and  mean  spectral  propagation  direction  for  the 
spectrum.  The  BCGEN  program  then  translates  those  characteristics  into  a 
spectrum  with  a  JONSWAP/TMA  spectral  shape  (Bouws  et  al.  1985)  with  a 
symmetric  spread  in  direction  defined  by  the  user.  Another  method  for 
entering  the  boundary  condition  spectrvuD  is  by  entering  the  JONSWAP/TMA 
spectral  description  parameters  with  a  user-defined  directional  spread. 

Another  method  is  to  enter  the  frequency  spectrum  directly,  in  which  case  only 
a  directional  spread  is  applied  to  the  spectrum.  The  user  may  also  enter  the 
complete  frequency- direction  spectrum,  in  which  case  the  spectrum  is  merely 
reformatted  for  use  in  STWAVE.  When  STWAVE  is  used  for  a  subgrid  simulation 
for  a  preceding  SHALWV  run,  the  input  boundary  condition  spectra  are  obtained 
from  the  spectral  data  saved  from  the  preceding  SHALWV  simulation.  Hence,  the 
user  does  not  have  to  specify  the  input  boundary  conditions,  i.e.,  in  this 
case  the  Boundary  Condition  File-Building  Routine  does  not  have  to  be  used. 

20.  A  feature  of  the  STWAVE  module  is  the  capability  to  simulate 
multiple  wave  conditions  during  a  single  execution  of  the  STWAVE  program. 

Using  this  capability,  multiple  design  wave  conditions,  or  a  pseudo  time- 
varying  simulation,  may  be  run  in  a  single  execution  of  STWAVE.  If  a  series 
of  boundary  conditions  are  entered,  the  user  will  be  prompted  for  a  wave 
spectrum  (or  its  "characteristics")  for  each  input  interval  specified  in 
question  GF-21. 
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21.  An  important  assumption  about  STWAVE's  boundary  conditions  is  that 
the  boundary  condition  spectra  specified  are  assumed  to  apply  across  the 
entire  input  boundary  of  the  grid  (Figure  8-1)  except  for  land  points,  which 
have  no  spectral  energy  associated  with  them.  In  some  cases,  this  is  a 
reasonable  assumption.  However,  in  cases  where  the  depths  along  the  input 
boundary  vary  considerably,  one  would  not  expect  the  wave  conditions  to  be  the 
same  across  the  boundary.  Therefore,  the  user  must  evaluate  the  grid  boundary 
and  use  the  most  appropriate  wave  condition. 

22.  The  descriptions  below  outline  the  questions  with  which  the  module 
prompts  the  user  to  gather  information  for  generating  the  input  boundary 
conditions.  The  module  will  build  a  data  file,  and  then  the  BCGEN  must  be  run 


to  generate  the  boundary  condition  spectrum. 
Input  descriptions 


BC-1 


PATH: 


BC-2 


Question  ;  General  Flle-Bulldlng  Routine  has  been  run?  (yes  /  no)  > 

Options  :  y  (or  Y)  -  General  File-Building  Routine  has  been  run. 

n  (or  N)  —  General  File-Building  Routine  has  not  been  run. 

Preselect:  None. 

Define  :  Some  of  the  files  generated  by  the  General  File- Building 
Routine  must  exist  prior  to  using  this  Boundary  Condition 
File-Building  Routine. 

Caution  :  If  the  General  File-Building  Routine  has  not  been  run,  but 
the  user  answers  yes,  an  error  will  occur  when  the  Boundary 
Condition  File-Buildi’^g  Routine  searches  for  the  existence 
of  files  created  by  the  General  File-Building  Routine.  The 
Boundary  Condition  File-Building  Routine  will  end. 

o  IF  GENERAL  FILE-BUILDING  ROUTINE  HAS  NOT  BEEN  RUN  (Option  'no', 
question  BC-l),  END  THE  BOUNDARY  CONDITION  FILE- BUILDING  ROUTINE. 

Question  :  Enter  TIME  VARIATION  OPTIONS  > 

Options  :  1  -  Constant  spectra  over  time . 

2  -  Variable  spectra  over  time. 

Preselect:  None. 


Define  :  If  time- invariant  boundary  conditions  are  selected,  the  user 
will  be  prompted  for  a  single  set  of  boundary  condition 
data,  which  will  be  used  for  the  entire  simulation  period. 

If  time -varying  boundary  conditions  are  selected,  the  user 
will  be  prompted  for  boundary  conditions  for  every  input 
interval  of  the  simulation  as  specified  in  question  GF-21. 
The  time-varying  option  would  be  used  if  the  user  were  going 
to  simulate  several  design  wave  conditions  during  a  single 
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execution  of  STWAVE,  or  if  he  is  simulating  the  time- 
variation  of  wave  conditions  by  a  series  of  time- independent 
wave  conditions. 

Caution  None . 

BC-3  Question  :  Enter  BOUNDARY  CONDITION  OPTION  > 

Options  1  -  Input  wave  characteristics. 

2  -  Input  spectral  characteristics . 

3  -  Input  one -dimensional  frequency  spectirum. 

4  -  Input  two-dimensional  frequency- direction  spectrum. 

Preselect:  None. 

Define  The  user  must  specify  the  method  for  creating  the  boundary 

condition  spectrum.  Option  1  will  require  him  to  enter  an 
energy-based  wave  height,  peak  spectral  period,  and  mean 
spectral  propagation  direction  for  each  boundary  condition. 
Option  2  will  require  the  user  to  enter  the  peak  spectral 
frequency,  Phillips'  Equilibrium  constant,  spectral 
peakedness  factor,  and  the  spectral  peak-width  factors. 

[See  question  GF-27,  Chapter  7.]  Options  3  and  4  will 
require  the  user  to  enter  the  frequency  and  frequency- 
direction  spectrvim,  respectively. 

Caution  :  None. 

PATH:  o  IF  ONE- DIHENS lONAL  SPECTRUM  IS  ENTERED  (Option  3,  question  BC-3), 
GO  TO  BC-5. 

o  IF  TWO-DIMENSIONAL  SPECTRUM  IS  ENTERED  (Option  4.  question  BC-3}, 
GO  TO  BC-9. 

BC-4  Question  :  Enter  FREQUENCY  SPECTRAL  SHAPE  OPTION  > 

Options  1  -  Klttlgoradski,  deep  and  shallow. 

2  -  Pierson-Moskowitz,  deep  only. 

3  -  JONSWAP,  deepwater  with  mean  values. 

4  -  JONSWAP/TMA,  computed  alpha  and  gamma. 

Preselect:  BC-3,  options  1  or  2. 

Define  When  the  input  boundary  conditions  will  not  be  given  as  an 

explicit  spectrum  (i.e.,  frequency  or  frequency-direction 
spectrum) ,  then  the  user  must  specify  the  type  of  frequency 
spectrum  that  should  be  generated  based  on  the  wave  or 
spectral  characteristics  he  will  be  entering  later.  The 
BCGEN  converts  the  wave  and  spectral  characteristics  into  a 
one -dimensional  spectrum  based  on  the  spectral  shape 
selected  here.  Option  4  is  recommended. 

Caution  :  None. 

BC-5  Question  :  Enter  DIRECTION  DISTRIBUTION  SHAPE  OPTION  > 
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Options  1  -  cos"”S 


PATH: 

BC-6 


PATH: 

BC-7 


PATH: 

BC-8 


2  -  cos2p(|) 

Preselect:  BC-3,  option  1,  2,  or  3. 


Define 


Caution 


As  with  the  spectral  shape  discussed  in  question  BC-4,  the 
shape  of  the  spread  of  the  spectrum  across  the  direction 
domain  must  be  specified.  The  user  will  be  asked  later  to 
enter  the  value  for  nn  ,  or  possibly  p  ,  depending  on  the 
option  that  is  selected.  The  shape  of  the  directional 
spreading  will  be  applied  to  any  type  of  input  boundary 
condition  to  generate  a  two-dimensional  spectrum,  except 
when  a  two-dimensional  spectrum  is  entered  explicitly. 
Option  1  is  recommended. 

None . 


o  IF  cos2p($/2)  SPREADING  FUNCTION  SELECTED  (Option  2,  question 
BC-5).  GO  TO  BC-7. 


Question 

Options 

Preselect 

Define 


Caution 


Enter  SPECTRAL  SPREADING  FUNCTION  EXPONENT  nn  > 

Variable . 

BC-3,  options  1,  2,  or  3;  BC-5,  option  1. 

The  spreading  function  exponent  is  the  value  of  nn  in  the 
expression  cos""tf  provided  in  question  BC-5.  A  low  value  of 
nn  will  provide  a  wide  spread  in  direction  about  the 
principal  propagation  direction  of  the  spectrum.  Higher 
values  for  nn  provide  a  spectrum  with  an  extremely  small 
directional  spread.  In  general,  a  value  of  4  may  be  used 
for  a  wind- sea  spectrum  and  a  value  of  8  for  a  swell 
spectrum. 

None . 


o  IF  cos"“«  SPREADING  FUNCTION  SELECTED  (Option  1,  question  BC-5), 
GO  TO  BC-9. 


Question  : 
Options  : 


Preselect: 
Define  : 


Caution 


Enter  p  COMPUTATION  OPTION  > 

1  -  p  value  computed. 

2  -  p  value  entered  interactively. 

BC-3,  option  1,  2,  or  3;  BC-5,  option  2. 

The  value  for  p  in  the  term  cos^P(fl/2)  provided  in 
question  BC-5  may  be  entered  interactively,  or  it  may  be 
computed  by  the  module.  The  derivation  of  p  is  based  on 
the  work  of  Hitsuyasu  (1981) . 

None . 


o  IF  p  VALUE  IS  COMPUTED  (Option  1,  question  BC-7),  GO  TO  BC-9. 
Question  :  Enter  SPREAD  PARAMETER  p  > 

Options  Variable. 
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Preselect:  BC-3,  options  1,  2,  3;  BC-5,  option  2;  BC-7,  option  2. 

Define  Low  values  for  p  provide  spectra  with  large  directional 

distributions  about  the  principal  direction  of  propagation. 
High  values  for  p  provide  spectra  with  small  directional 
distributions  about  the  principal  direction  of  propagation. 
Recommended  values  are  8  for  a  wind- sea  spectrum  or  16  for  a 
swell  spectrum . 

Caution  :  None. 

BC-9  Question  :  Enter  the  start  date  for  spectral  input  > 

Options  0  <  VALUE  <  99999999. 

Preselect;  None. 

Define  If  STWAVE  is  being  used  to  simulate  time-varying  wave 

conditions,  then  the  date  for  the  first  Input  boundary 
condition  must  be  specified.  The  module  automatically 
computes  the  dates  for  the  remaining  input  boundary 
condition  data  based  on  the  input  interval  which  is 
specified  in  question  GF-20. 

If  STWAVE  is  being  used  to  simulate  a  series  of  design  wave 
conditions,  enter  1.  This  will  force  the  date  to  act  as  a 
counter  for  each  wave  condition.  That  is,  the  first  design 
wave  condition  would  be  associated  with  "date  00000001,"  the 
second  condition  with  "date  00000002,"  and  so  on. 

Caution  :  None. 

PATH:  o  IF  SPECTRAL  WAVE  CHARACTERISTICS  ARE  ENTERED  (Option  2.  question 
BC-3),  GO  TO  BC-17. 

o  IF  ONE-OIHENSIONAL  SPECTRAL  DATA  ARE  ENTERED  (Option  3,  question 
BC-3),  GO  TO  BC-25. 

o  IF  TWO  DIMENSIONAL  SPECTRAL  DATA  ARE  ENTERED  (Option  4.  question 
BC-3),  GO  TO  BC-31. 

BC-10  Question  :  WAVE  CHARACTERISTICS  INPUT  OPTION  > 

Options  1  -  Read  data  from  file  with  dates. 

2  -  Read  data  from  file  without  dates. 

3  -  Enter  data  from  keyboard. 

Preselect:  BC-3,  option  1. 

Define  Select  the  desired  method  for  entering  wave  characteristics. 

Caution  If  option  1  or  2  is  selected,  a  file  containing  the  wave 
characteristics  data  must  be  available  and  specified  in 
question  BC-11.  The  formats  for  the  files  are  provided  in 
Part  IV,  Spectral  Wave  Modeling  Module  File  Descriptions. 

PATH:  o  IF  DATA  ARE  ENTERED  FROM  KEYBOARD  (Option  3,  question  BC-10,)  GO 
TO  BC-12. 
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BC-11  Question  :  Enter  WAVE  CHARACTERISTICS  filename  > 

Option  <  14  significant  characters. 

Preselect:  BC-3,  option  1;  BC-10,  option  1  or  2. 

Define  Since  the  user  indicated  in  question  BC-10  that  the  wave 

characteristics  data  are  to  be  read  from  a  file,  he  must 
provide  the  file  name.  If  no  valid  file  name  is  provided, 
the  Boundary  Condition  File -Building  Routine  will  be 
terminated. 

Caution  :  The  file  name  must  conform  to  the  UNIX  file-naming 

conventions  of  the  UNIX  operating  system,  i.e.,  only 
14  characters  are  significant. 

PATH:  o  IF  WAVE  CHARACTERISTIC  DATA  ARE  ENTERED  VIA  A  FILE  (Option  1  or  2, 
Question  BC-10)  THEN  END. 

BC-12  Question  :  Enter  WAVE  TYPE  OPTION  > 

Options  :  1  -  Wind- sea  conditions. 

2  -  Swell  conditions. 

Preselect:  BC-3,  option  1;  BC-10,  option  3. 

Define  :  The  user  must  specify  whether  the  input  boundary  conditions 
that  he  is  entering  represent  locally  generated  wind- sea  or 
swell.  The  BCGEN  will  convert  the  wave  characteristics  that 
the  user  enters  into  a  two-dimensional  spectriam  (frequency- 
direction  spectrum) .  The  method  of  conversion  depends  on 
whether  the  waves  are  specified  as  sea  or  swell.  This 
question  will  be  repeated  for  each  input  interval  that  is 
specified  in  question  GF-21,  unless  constant  input  boundary 
conditions  are  specified  in  question  BC-2. 

Caution  ;  None. 

BC-13  Question  :  Enter  the  WAVE  HEIGHT  (m)  > 

Options  :  Variable. 

Preselect:  BC-3,  option  1;  BC-10,  option  3. 

Define  :  The  user  must  enter  the  energy-based  wave  height  to  be  used 
as  an  input  boundary  condition. 

Caution  :  Units  must  be  in  meters  (m) . 

BC-14  Question  :  Enter  PEAK  SPECTRAL  WAVE  PERIOD  (sec)  > 

Options  :  Variable . 

Preselect:  BC-3,  option  1;  BC-10,  option  3. 

Define  :  The  user  must  enter  the  peak  spectral  wave  period  associated 
with  the  wave  height  identified  in  question  BC-13. 

Caution  :  Units  must  be  in  seconds  (sec) . 

BC-15  Question  :  Enter  MEAN  PROPAGATION  DIRECTION  (deg)  > 


8-26 


Options 

Preselect 

Define 

Caution 

BC-16  Question 
Options 
Preselect 
Define 


Caution 


0  <  VALUE  <  360. 

BC-3,  option  1;  BC-10,  option  3. 

The  user  must  enter  the  mean  propagation  direction  of  the 
wave  spectunam  to  be  used  as  an  Input  boundary  condition. 

Units  must  be  in  degrees  (deg)  using  the  Cartesian  reference 
system  shown  in  Figure  8-1. 

Enter  WATER  DEPTH  (m)  > 

Variable. 

BC-3,  option  1;  BC-10,  option  3. 

The  user  must  enter  the  water  depth  associated  with  the 
spectral  wave  boundary  condition  described  in  questions 
BC-13  through  BC-15.  It  is  recommended  that  the  average 
depth  along  the  input  boundary  of  the  grid  be  used.  The 
input  wave  energy  spectrum  applied  along  the  input  boundary 
of  the  grid  is  derived  based  on  this  water  depth. 

Units  must  be  in  meters  (m) . 


PATH  :  o  IF  BOUNDARY  CONDITIONS  ARE  CONSTANT  (option  1.  question  BC-2). 
THEN  END. 

o  IF  BOUNDARY  CONDITIONS  ARE  NOT  CONSTANT  (option  2,  question  BC-2), 
THEN  REPEAT  QUESTIONS  BC-12  THROUGH  BC-16  UNTIL  ALL  BOUNDARY 
CONDITIONS  ARE  ENTERED,  THEN  END. 

BC-17  Question  ;  Enter  WAVE  TYPE  OPTION  > 

Options  1  -  Wind- sea  conditions. 

2  -  Swell  conditions. 


Preselect 
Define 
Caution 
BC-18  Question 
Options 
Preselect 
Define 

Caution 

BC-19  Question 
Options 
Preselect 


BC-3,  option  2. 

See  description  in  BC-12. 

None. 

Enter  the  PEAK  SPECTRAL  FREQUENCY  (Hz)  > 

>  0. 

BC-3,  option  2. 

The  peak  frequency  (f,)  of  the  spectrum  must  be  specified. 
[See  question  GF-27,  Chapter  7.] 

Units  must  be  in  Hertz  (Hz). 

Enter  the  PHILLIPS'  EQUILIBRIUM  CONSTANT  > 

0  <  VALUE  <0.1. 

BC-3,  option  2. 


Define 


The  Phillips'  Equilibrium  constant  for  the  spectrum  must  be 
specified.  [See  question  GF-27,  Chapter  7.] 
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Caution 

BC-20  Question 
Options 
Preselect 
Define 

Caution 

BC-21  Question 
Options 
Preselect 
Define 


Caution 


None . 

Enter  the  SPECTRAL  PEAKEDNESS  FACTOR  > 

1  <  VALUE  <  20. 

BC-3,  option  2. 

The  "peakedness"  factor  for  the  spectrum  must  be  specified. 
[See  question  GF-27,  Chapter  7.] 

None . 

Enter  the  SPECTRAL  WIDTH  FACTOR  > 

0  <  VALUE  <0.2. 

BC-3,  option  2. 

The  spectral  peak  width  factor  for  frequencies  below  the 
peak  spectral  frequency  must  be  specified.  [See  question 
GF-27,  Chapter  7.] 

None . 


BC-22  Question 
Options 
Preselect 
Define 

Caution 
BC-23  Question 
Options 
Preselect 
Define 


Caution 

BC-24  Question 
Options 
Preselect 


Enter  the  SPECTRAL  WIDTH  FACTOR  > 

0  <  VALUE  <0.2. 

BC-3,  option  2. 

The  spectral  peak  width  factor  for  frequencies  above  the 
peak  spectral  frequency  must  be  specified.  [See  question 
GF-27,  Chapter  7.] 

None. 

Enter  the  MEAN  SPECTRAL  PROPAGATION  DIRECTION  (deg)  > 

0  <  VALUE  <  360. 

BC-3,  option  2. 

The  mean  propagation  direction  of  the  spectrum  must  be 
specified.  The  directional  distribution  specified  in 
question  BC-5  will  be  applied  about  the  mean  propagation 
direction. 

Units  must  be  in  degrees  (deg)  using  the  Cartesian  reference 
system  shown  in  Figure  8-1. 

Enter  the  WATER  DEPTH  (m)  > 

Variable . 

BC-3,  option  2. 


Define 
Caution 
PATH  :  o 


See  question  BC-15  above. 
Units  must  be  in  meters  (m) 


IF  BOUNDARY  CONDITIONS  ARE  CONSTANT  (option  1,  question  BC-2), 
THEN  END. 
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o  IF  BOUNDARY  CONDITIONS  ARE  NOT  CONSTANT  (option  2,  question  BC-2), 
THEN  REPEAT  QUESTIONS  BC-17  THROUGH  BC-24  UNTIL  ALL  BOUNDARY 
CONDITIONS  ARE  ENTERED,  THEN  END. 

BC-25  Question  :  Enter  1-D  SPECTRA  INPUT  OPTION  > 

Options  1  Read  headers  and  spectra  from  a  file. 

2  -  Enter  headers  and  spectra. 

3  -  Enter  headers,  read  spectra  from  a  file. 

Preselect:  BC-3,  option  3. 

Define  The  method  for  entering  the  one -dimensional  spectra  must  be 

specified.  The  header  contains  the  following  Information: 
the  wave-type  option  (question  BC-27),  the  mean  spectral 
propagation  direction  (question  BC-28),  and  the  water  depth 
for  the  input  boundary  conditions  (question  BC-29).  If  the 
headers  are  read  from  a  file,  then  questions  BC-27  through 
BC-29  will  not  be  asked. 

Caution  :  If  option  2  is  selected,  the  user  will  be  required  to  Input 
the  headers  and  the  spectra  interactively.  The  spectra  must 
contain  energy  density  values  for  each  frequency  band 
(question  GF-8)  for  each  input  interval  (question  GF-20), 
unless  constant  boundary  conditions  are  selected  in  question 
BC-2. 

PATH:  o  IF  SPECTRAL  DATA  ARE  ENTERED  INTERACTIVELY  (Option  2,  question  BC- 
25),  GO  TO  BC-27. 

BC-26  Question  :  Enter  the  name  of  the  SPECTRAL  DATA  FILE  > 

Options  :  ^  14  significant  characters. 

Preselect:  BC-3,  option  3;  BC-25,  option  1  or  3. 

Define  The  name  of  the  file  containing  the  one -dimensional 

frequency  spectral  data  must  be  entered. 

Caution  If  the  file  name  entered  is  improper,  or  if  an  error  occurs 
while  the  module  reads  the  file,  the  Boundary  Condition 
File-Building  session  will  terminate.  No  Information  will 
be  saved.  The  user  will  have  to  correct  the  file  before 
rerunning  the  Boundary  Condition  File-Building  Routine. 

The  file  name  must  conform  to  the  file-naming  conventions  of 
the  UNIX  operating  system,  i.e.,  14  significant  characters. 

PATH:  o  IF  SPECTRAL  DATA  AND  HEADERS  ARE  ENTERED  BY  FILE  (Option  1, 

question  BC-25),  END  BOUNDARY  CONDITION  FILE-BUILDING  ROUTINE. 

BC-27  Question  :  Enter  WAVE  TYPE  OPTION  > 

Options  1  -  Wind- sea  conditions. 

2  -  Swell  conditions. 

3  -  Sea  and  swell  conditions. 
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Preselect:  BC-3,  option  3;  BC-25,  option  2  or  3. 

Define  See  question  BC-12  above. 

Caution  None . 

BC-28  Question  :  Enter  MEAN  SPECTRAL  PROPAGATION  DIRECTION  (deg)  > 

Options  :  0  <  VALUE  <  360. 

Preselect:  BC-3,  option  3;  BC-25,  option  2  or  3. 

Define  :  The  mean  direction  of  propagation  of  the  spectra  must  be 

specified.  The  module  will  apply  the  specified  directional 
distribution  shape  selected  in  question  BC-5  about  the  mean 
direction. 

Caution  :  Units  must  be  in  degrees  (deg)  using  the  Cartesian  reference 
system  illustrated  in  Figure  8-1. 

BC-29  Question  :  Enter  WATER  DEPTH  (m)  > 

Options  :  Variable. 

Preselect:  BC-3,  option  3;  BC-25,  option  2  or  3. 

Define  :  The  user  must  enter  the  water  depth  associated  with  the 

spectra  entered.  It  is  recommended  that  an  average  depth  be 
used  for  the  input  boundary  of  the  grid. 

Caution  :  Units  must  be  in  meters  (m) . 

PATH:  o  IF  SPECTRAL  DATA  ARE  ENTERED  BY  FILE  (Option  3,  question  BC-25), 
END  BOUNDARY  CONDITION  FILE-BUILDING  ROUTINE. 

BC-30  Question  :  Enter  the  1-D  FREQUENCY  SPECTRA  (mVHz)  > 

Spectral  Energy  Value  ##: 

Options  :  Variable . 

Preselect:  BC-3,  option  3;  BC-25,  option  3. 

Define  :  The  spectral  energy  density  values  must  be  entered  for  each 
frequency  band  in  the  spectrum  (question  GF-8). 

Caution  :  The  first  spectral  energy  value  corresponds  to  the  lowest 
frequency.  Units  must  be  in  m^/Hz. 

PATH:  o  END  BOUNDARY  CONDITION  FILE- BUILDING  ROUTINE. 

BC-31  Question  :  Enter  2-D  SPECTRA  INPUT  OPTION  > 

Options  1  —  Read  headers  and  spectra  from  a  file. 

2  -  Enter  headers,  read  spectra  from  a  file. 

Preselect:  BC-3,  option  4. 

Define  :  The  method  for  entering  the  two-dimensional  spectra  must  be 
specified.  The  header  includes  the  values  for  the  wave  type 
option,  the  water  depth,  the  wind  speed,  and  wind  direction 
(questions  BC-33  through  BC-36). 
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Caution  None. 


BC-32  Question 
Options 
Preselect 
Define 


Caution 


Enter  the  name  of  the  SPECTRAL  DATA  FILE  > 

<  14  significant  characters. 

BC-3,  option  4. 

The  spectral  data  file  name  must  be  provided.  This  file 
contains  the  two-dimensional  wave  energy  spectra  information 
in  the  format  described  in  Part  IV,  Spectral  Wave  Modeling 
Module  File  Descriptions. 

The  file  name  must  conform  to  the  file-naming  conventions  of 
the  UNIX  operating  system,  i.e. ,  up  to  14  significant 
characters.  If  no  file  name  is  provided  or  an  error  is 
encountered  when  the  module  reads  the  file ,  the  Boundary 
Condition  File-Building  Routine  will  end.  No  information 
will  be  saved.  The  user  must  correct  the  file  before  the 
Boundary  Condition  File-Building  Routine  can  be  rerun. 


PATH:  o  IF  HEADERS  ARE  ENTERED  BY  FILE  (Option  1,  question  BC-31),  END 
BOUNDARY  CONDITION  FILE-BDILDING  ROUTINE. 


BC-33  Question  : 
Options  : 


Preselect 

Define 

Caution 

BC-34  Question 
Options 
Preselect 
Define 


Caution 

BC-35  Question 
Options 
Preselect 
Define 


Enter  WAVE  TYPE  OPTION  > 

1  -  Wind- sea  conditions. 

2  -  Swell  conditions. 

3  ->  Sea  and  swell  conditions. 

BC-3,  option  4;  BC-31,  option  2. 

See  question  BC-12  above. 

None . 

Enter  WATER  DEPTH  (m)  > 

Variable. 

BC-3,  option  4;  BC-31,  option  2. 

The  user  must  enter  the  water  depth  associated  with  the 
spectra  entered.  The  water  depth  will  be  assumed  to  be 
valid  at  every  point  along  the  input  boundary  of  the  grid 
(question  BC-16).  It  is  recommended  that  an  average  depth 
be  used  for  the  input  boundary  of  the  grid. 

Units  must  be  in  meters  (m) . 

Enter  WIND  SPEED  (knots)  > 

0  <  VALUE  <  100. 

BC-3,  option  4;  BC-31,  option  2. 

The  wind  speed  is  used  to  separate  the  spectrum  into  wind- 
sea  spectra  and  swell  spectra.  It  is  assumed  that  energies 
in  spectral  frequencies  with  phase  speeds  greater  than  the 
wind  speed  are  part  of  the  swell  spectrum.  Those  energies 
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Caution 


BC-36  Question 
Options 
Preselect 
Define 

Caution 


in  spectral  frequencies  with  phase  speeds  less  than  the  wind 
speed  are  part  of  the  wind-sea  spectrum. 

The  wind  speed  must  be  given  in  knots  and  must  represent  the 
equivalent  overwater,  10-m  elevation,  neutrally  stable 
value.  If  the  user  selected  option  1  or  2  in  question  BC- 
33,  then  the  spectrum  has  already  been  identified  as  wind- 
sea  or  swell ,  and  the  wind  speed  entered  here  will  be 
ignored. 

Enter  WIND  DIRECTION  (deg)  > 

0  <  VALUE  <  360. 

BC-3,  option  4;  BC-31,  option  2. 

Wind  direction  associated  with  wind  speed  entered  on 
question  BC-35. 

The  units  must  be  in  degrees  (deg)  using  the  Cartesian 
reference  system  shown  in  Figure  8-1. 


END  BOUNDARY  CONDITION  FILE- BUILDING  ROUTINE 


Function  to  Run  Programs 


23.  If  a  user  is  ready  to  run  the  module  programs  for  a  particular 
application,  then  the  task  of  composing  and  formatting  all  of  the  necessary 
input  data  into  the  proper  files  has  been  completed.  Running  the  programs 
simply  entails  specifying  which  program  should  be  run.  In  most  cases,  the 
BCGEN  program  will  be  run  first  to  create  input  boundary  conditions  for 
STWAVE,  and  then  STWAVE  will  be  run  to  simulate  the  transformation  of  the 
boundary  conditions  across  the  computational  grid.  The  only  exception  is  when 
STWAVE  is  used  to  conduct  a  subgrid  simulation  of  a  preceding  SHALWV 
simulation. 

Running  BCGEN 

24.  The  Boundary  Condition  File-Building  Routine  must  be  used  to  build 
the  input  file  for  the  BCGEN  prior  to  running  the  program.  The  BCGEN  program 
is  then  run  to  generate  the  input  boundary  conditions  for  STWAVE.  When  an 
STWAVE  simulation  is  a  subgrid  computation  for  c.  previous  SHALWV  run,  then 
the  BCGEN  is  not  used  because  the  boundary  conditions  for  STWAVE  will  be 
obtained  from  the  preceding  SHALWV  simulation  (described  in  Part  II) . 
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Running  STWAVE 

25.  When  the  STWAVE  program  is  selected,  the  user  is  asked  to  specify  a 
reference  name  under  which  the  STWAVE  output  data  will  be  stored.  The 
reference  name  must  conform  to  the  file-naming  conventions  of  the  UNIX 
operating  system  and  should  NOT  have  a  file  name  extension,  like  ".dat"  or 
".out."  (The  UNIX  file-naming  convention  allows  up  to  14  significant 
characters,  including  the  extension.)  The  module  uses  the  reference  name  to 
create  three  output  files  (described  in  Part  IV) .  Each  file  has  the  user- 
specified  reference  name  with  a  unique  extension. 

26.  The  first  output  file  created  by  STWAVE  is  the  Wave  Field  File 
(given  the  ".mtx"  extension),  which  contains  the  energy-based  wave  height, 
peak  spectral  period,  and  mean  spectral  propagation  direction  for  each  grid 
point  for  each  output  interval  (specified  in  question  GF-21)  of  the 
simulation.  The  second  output  file  is  the  Wave  Spectra  File  (given  the  ".spe" 
extension) ,  which  contains  the  frequency  and  frequency -direction  spectra  for 
each  specified  output  location  (questions  GF-22  &  GF-23)  and  for  each  output 
interval.  The  third  output  file  is  the  Wave  Characteristics  File  (given  the 
extension  ".sea"),  which  contains  the  energy-based  wave  height,  peak  spectral 
period,  and  mean  spectral  propagation  direction  for  each  specified  output 
location  and  for  each  output  interval. 

Function  to  Plot/Print  STWAVE  Output 

27.  The  graphical  and  statistical  post-processing  features  of  the  module 
for  STWAVE  are  identical  to  those  for  SHALWV.  Hence,  the  user  may  refer  to 
Chapter  7  for  more  information. 


8-33 


PART  IV:  SPECTRAL  WAVE  MODELING  MODULE  FILE  DESCRIPTIONS 


STWAVE  Files 


28.  The  organization  of  the  files  used  in  the  STWAVE  branch  of  the 
Spectral  Wave  Modeling  module  is  shown  in  Figures  8-3  through  8-5.  A  list  of 
all  of  the  files  (and  related  file  numbers)  used  by  the  STWAVE  branch  of  the 
CMS  Spectral  Wave  Modeling  module  is  provided  in  Table  8-1.  The  reference 
numbers  in  Table  S-1  match  the  numbers  given  in  Figures  8-3  and  8-4.  In 
general,  the  creation,  organization,  and  usage  of  almost  all  of  the  files  in 
the  CMS  Spectral  Wave  Modeling  module  are  transparent  to  the  user.  That  is, 
the  module  creates  and  organizes  the  files,  prompting  the  user  for  information 
only  when  necessary.  For  reference,  however,  a  brief  description  of  the  data 
and  data  format  required  by  each  file  is  provided  below. 


Table  8-1 
STWAVE  Files 


File  Title 

Name 

Reference 

Number 

General  Input  File 

stwavein. swv 

2 

Bathymetry  File 

user- specified 

1 

Spectral  Data  File 

user-specified 

7 

BCGEN  Input  File 

boundin. swv 

8 

Boundary  Condition  File  (for  STWAVE) 

boundout . swv 

3 

Wave  Field  Output  File 

user-specified  + 

.  mtx 

9 

Wave  Spectra  Output  File 

user-specified  + 

.  spe 

10 

Wave  Characteristics  Output  File 

user-specified  + 

.  sea 

11 

Parameter  File 

f ilel . swv 

4 

Main  File  Name  File 

f ilenmi . swv 

5 

Post-Processing  File  Name  File 

f ilenmpst . swv 

12 

Wave  Characteristics  Input  File 

user-specified 

6 

6 


29.  The  General  Input  File  is  one  of  the  files  built  by  the  General 
File-Building  Routine.  The  General  Input  File  contains  program  flow  control 
parameters  for  STWAVE,  spectral  frequency  and  direction  discretization 
parameters,  computational  grid  parameters,  and  node  locations  for  output  of 
model  results. 

a.  RECORD  1,  Format  (215,  3F10.2). 

Field  1  -  Number  of  columns  in  grid  (Figure  8-1). 

Field  2  -  Number  of  rows  in  grid  (Figure  8-1). 

Field  3  -  Length  dimension  of  grid  column  (m) . 

Field  4  -  Length  dimension  of  grid  row  (m) . 

Field  5  -  Grid  rotation  angle  (Figure  8-1). 

b.  RECORD  2,  Format  (15,  2F10.3). 

Field  1  -  Number  of  spectral  frequency  bands . 

Field  2  -  First  frequency  band  value  (Hz) . 

Field  3  -  Frequency  band  increment  (Hz) . 

£.  RECORD  3,  Format  (15,  P10.2). 

Field  1  -  Number  of  spectral  direction  bands . 

Field  2  -  Extreme  exclusion  angle  (deg) . 

d.  RECORD  4,  Format  (15). 

Field  1  -  1 

e.  RECORD  5,  Format  (1115,  F10.2). 

Fields  1-4  -  0 

Field  5  -  Number  of  special  output  locations . 

Fields  6-8  -  0 

Field  9  -  3 

Field  10  -  Number  of  hours  between  input  boundary 

conditions . 

Field  11  -  Number  of  input  boundary  conditions. 

Field  12  -  Depth  unit  conversion  factor. 

f.  RECORD  6,  Format  (215).  (Repeated  for  each  special  output 
location. ) 

Field  1  -  Column  for  special  output  location. 
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Field  2  -  Row  for  special  output  location. 


Bathymetry  File 

30.  The  Bathymetry  File  can  be  built  during  operation  of  the  General 
File-Building  Routine.  However,  because  the  number  of  bathymetry  data  is 
usually  large,  it  is  recommended  that  users  build  this  file  using  the  most 
convenient  editor  available  to  them.  The  Bathymetry  File  is  a  matrix  of 
numbers  indicating  the  depth  at  each  point  on  the  computational  grid  (see 
questions  GF-13  through  GF-19).  Depth  values  may  be  entered  in  any  units 
desired,  but  they  must  all  have  the  SAME  units.  A  depth-unit  conversion 
factor  must  be  entered  during  the  General  File -Building  Routine  (question  GF- 
14)  to  convert  the  user's  depth  units  to  meters. 

a.  If  Field  6  on  REGORD  2  of  the  General  Input  File  is  1,  then 
Format  (F6.0). 

Field  1  -  Uniform  (constant)  water  depth  value . 

b.  If  Field  6  on  REGORD  2  of  the  General  Input  File  is  2,  then 
Format  (21F6.0). 

Fields  1-21  -  Matrix  of  depth  values  for  each  point  on 

the  computational  grid.  Values  equal  to  zero 
(0.0)  are  considered  land. 

Note:  Only  21  values  are  allowed  per  row.  If  the  computational 
grid  has  more  than  21  values  on  a  row,  then  21  values  are 
entered  on  the  first  record  and  the  remaining  numbers  are 
placed  on  additional  records  until  the  entire  row  of  values 
has  been  entered.  The  second  and  subsequent  rows  of  the 
computational  grid  begin  on  a  new  record. 

BCGEN  Input  File 

31.  The  BCGEN  Input  File  is  generated  by  the  Boundary  Condition  File- 
Building  routine  to  be  used  as  input  to  the  BCGEN  program.  The  BCGEN  Input 
File  contains  the  program  control  parameters  and  necessary  information  for 
generating  boundary  conditions  for  the  STWAVE  simulation.  It  is  recommended 
that  this  file  be  created  and  modified  only  through  the  Boundary  Condition 
File-Building  Routine,  so  that  consistency  can  be  maintained  in  file 
organization  and  program  control  parameters. 

a.  RECORD  1,  Format  (215). 

Field  1  -  1  -  Boundary  conditions  are  constant. 

2  -  Boundary  conditions  are  time-varying. 
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Field  2  -  1  -  Wave  characteristics  are  specified. 

2  -  Wave  spectral  parameters  are  specified. 

3  -  One -dimensional  spectra  are  specified. 

4  -  Two-dimensional  spectra  are  specified. 

b.  RECORD  2,  Format  (2F10.2). 

Field  1  -  Extreme  angle  exclusion  (deg) . 

Field  2  -  Rotation  angle  for  grid  (deg  Cartesian) . 

c.  RECORD  3,  Format  (815). 

Field  1  -  Number  of  spectral  frequency  bands. 

Field  2  -  Number  of  spectral  direction  bands. 

Field  3  -  0  -  frequency  band  values  are  computed. 

Field  4  -  Spectral  shape  criteria  where: 

4  -  TMA 

Field  5  -  Spectral  spreading  function  where: 

1  -  cos™^ 

2  -  cos^P(tf/2)  (Gamma  Function) 

Field  6  -  3 

Field  7  -  0 

Field  8  -  Specifies  method  for  determining  p  in  spectral 
spreading  function  specified  in  Field  5  where: 

0  -  p  computed. 

1  -  p  entered. 

d.  RECORD  4,  Format  (15).  If  Field  5  on  RECORD  3  is  1,  then  this 
record  is  used. 

Field  1  -  nn,  the  spectral  spreading  exponent. 

e.  RECORD  5,  Format  (F5.1).  If  Field  5  on  RECORD  3  is  2,  and 
Field  8  on  RECORD  3  is  1,  then  this  record  is  used. 

Field  1  -  p,  the  spectral  spreading  exponent. 

f.  RECORD  6,  Format  (10F7.4).  If  Field  3  on  RECORD  3  is  1,  then 
this  record  is  used. 

Fields  1-10  -  frequency  band  values  (Hz).  An  additional 
record  may  be  used. 

g.  RECORD  7,  Format  (2F7.4).  If  Field  3  on  RECORD  3  is  0,  then 
this  record  is  used. 

Field  1  -  Initial  frequency  band  value  (Hz). 

Field  2  -  Frequency  band  value  interval  (Hz). 
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il.  RECORD  8,  Format  (15). 

Field  1  -  Maximum  number  of  input  intervals . 

i.  RECORD  9,  Format  (15). 

Field  1  -  Number  of  input  boundary  condition  locations . 

j. .  RECORD  10,  Format  (315,  F8.2). 

Field  1  -  0  -  Main  input  side. 

Field  2  -  Input  boundary  condition  column  location. 

Field  3  -  Input  boundary  condition  row  location. 

Field  4  -  Depth  at  input  boundary  condition  location. 

This  record  is  repeated  for  each  input  boundary  condition 
location. 

k.  RECORD  11,  Format  (15,  4F6  1,  110).  If  Field  2  of  RECORD  1 

is  1,  then  this  record  is  used.  A  record  is  required  for  each 

input  time  interval. 

Field  1  -  Wave  type  option. 

Field  2  -  Wave  height  (m) . 

Field  3  -  Wave  period  (sec). 

Field  4  -  Wave  propagation  direction  (deg  Cartesian) . 

Field  5  -  Water  depth  (m) . 

Field  6  -  Date/time  for  input  (yymmddhh) . 

l.  RECORD  12,  Format  (15,  2F6.4,  2F6.1,  F6.1,  F7.2,  110).  If 

Field  2  of  RECORD  1  is  2,  then  this  record  is  used.  A  record 

is  required  for  each  input  time  interval . 

Field  1  -  Wave  type  option. 

Field  2  -  Peak  spectral  frequency  (Hz),  f„. 

Field  3  -  Phillips'  Equilibrium  Constant,  o. 

Field  4  -  Spectral  peakedness  factor,  y. 

Field  5  -  Frequency  shape  factor,  a^. 

Field  6  -  Frequency  shape  factor, 

Field  7  -  Mean  propagation  direction  (deg  Cartesian). 

Field  8  -  Water  depth  (m) . 

Field  9  -  Date/time  for  input  (yymmddhh) . 

m.  RECORD  13,  Format  (15,  2F6.1,  110).  If  Field  2  of  RECORD  1  is 
3,  then  RECORDS  13  and  14  are  used.  A  set  of  records  is 
required  for  each  input  time  interval. 

Field  1  -  Wave  type  option. 

Field  2  -  Mean  propagation  direction  (deg  Cartesian) . 
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Field  3  -  Water  depth  (m) . 

Field  4  -  Date/time  for  input  (yynunddhh) . 

n.  RECORD  14.  Format  (6G12.5). 

Fields  1-10  -  Spectral  energy  values  for  each  frequency  band 
in  Values  must  be  provided  from  lowest 

to  highest  frequency  band. 

An  additional  record  may  be  used  for  more  frequency  bands . 

o.  RECORD  15,  Format  (15,  3F6.1,  110).  If  Field  2  of  RECORD  1  is 
4,  then  RECORDS  15  and  16  are  used.  A  set  of  records  is 
required  for  each  input  time  interval. 

Field  1  -  Wave  type  option. 

Field  2  -  Water  depth  (m) . 

Field  3  -  Wind  speed  (knots) . 

Field  4  -  Wind  direction  (deg  Cartesian) . 

Field  5  -  Date/time  for  input  (yymmddhh) . 

E.  RECORD  16,  Format  (6G12.5). 

Fields  1-10  -  Spectral  energy  values  for  each  direction  band 
for  a  given  frequency  band  (tinits  are 
mV(Hz*rad)).  Values  must  be  provided  starting 
with  the  0-deg  band  and  the  lowest  frequency 
band. 

Additional  records  may  be  used  for  more  frequency  bands. 
Spectral  Data  File 

32.  The  Spectral  Data  File  contains  wave  energy  spectra  which  the  BCGEN 
program  uses  to  generate  boundary  conditions  for  STWAVE.  The  Spectral  Data 
File  may  contain  either  one-  or  two-dimensional  spectral  information  for  each 
input  interval  specified  in  question  GF-21.  If  time -invariant  boundary 
conditions  are  specified  during  the  Boundary  Condition  File-Building  Routine, 
then  only  one  spectrum  is  required  for  each  input  station.  Descriptions  for 
the  question  numbers  provided  with  the  file  data  fomat  below  can  be  found  in 
Part  III,  Module  Functions  and  Routines. 

One-Dlmenslonal  Input  Boundary  Condition  Spectra 
a .  RECORD  1 ,  Free  Format . 

This  record  is  only  used  if  Headers  are  specified  as  being  read 
from  a  file  during  the  Boundary  Condition  File-Building 
Routine . 

Field  1  -  Wave  type  option  (question  BC-27). 

Field  2  -  Mean  propagation  direction  (question  BC-28). 
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Field  3  -  Water  depth  (question  BC-29). 

RECORD  2,  Free  Format. 

The  fields  on  this  record  are  filled  with  spectral  values  (up 
to  132  characters/record) .  Several  records  may  be  used  to 
enter  all  of  the  spectral  values.  The  energy  values  associated 
with  each  frequency  should  be  in  units  of  mVHz .  The  values 
should  be  provided  from  the  lowest  to  the  highest  frequency 
band. 

RECORDS  1  and  2  are  repeated  for  each  data  input  interval . 
Two-Dimensional  Input  Boundary  Condition  Spectra 
a.  RECORD  1,  Free  Format. 

This  record  is  only  used  if  headers  are  specified  as  being  read 
from  a  file  during  the  Boundary  Condition  File-Building 
Routine . 

Field  1  -  Wave  type  option  (question  BC-33). 

Field  2  -  Water  depth  (question  BC-34). 

Field  3  -  Wind  speed  (question  BC-35). 

Field  4  -  Wind  direction  (question  BC-36). 

RECORD  2,  Free  Format. 

The  fields  on  this  record  are  filled  (up  to  132  characters/ 
record)  until  all  of  the  spectral  values  for  a  given  frequency 
are  entered.  Several  records  may  be  used.  The  spectral  energy 
is  entered  for  each  direction  band  for  a  given  frequency, 
beginning  with  the  band  at  0  deg  in  a  Cartesian  coordinate 
system  (see  Figure  8-1).  After  the  values  for  each  direction 
in  a  frequency  band  have  been  entered,  a  new  frequency  band  is 
selected  and  a  new  record  must  be  used.  Several  records  may  be 
used.  The  energy  values  associated  with  each  frequency  should 
be  in  units  of  mV(Hz-rad).  The  data  should  be  provided  from 
the  lowest  to  the  highest  frequency  band. 

RECORDS  1  and  2  are  repeated  for  each  data  input  interval. 
Boundary  Condition  File  (for  STWAVE') 

33.  The  Boundary  Condition  File  (for  STWAVE)  is  output  from  the  BCGEN 
program.  The  data  for  this  file  are  written  in  binary  form  and,  therefore, 
the  format  is  not  described. 

Subgrid  Boundary  Condition  File 

34.  The  Subgrid  Boundary  Condition  File  is  created  by  SHALWV  for  use  by 
STWAVE.  SHALWV  fills  the  file  with  boundary  condition  information  for  a 
subsequent  STWAVE  subgrid  simulation.  The  data  are  written  to  the  file  in 
binary  form.  Therefore,  format  and  data  within  the  file  are  not  described. 
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Wave  Field  Output  File 

35.  The  Wave  Field  Output  File  contains  the  energy-based  significant 
wave  height,  the  peak  spectral  period,  and  the  mean  spectral  propagation 
direction  for  each  point  on  the  computational  grid  for  each  output  Interval 
specified  in  question  GF-21.  The  data  are  oriented  in  the  file  for  a  given 
output  interval  with  the  matrix  of  energy-based  wave  heigihts  provided  first, 
followed  by  the  peak  spectral  wave  periods,  and  then  the  mean  spectral 
propagation  directions. 

Wave  Spectra  Output  File 

36 .  The  Wave  Spectra  Output  File  contains  the  frequency  and  frequency- 
direction  wave  energy  spectra  for  each  output  location  specified  in  questions 
GF-22  and  GF-23  for  each  output  time  interval  specified  in  question  GF-21. 

The  first  record  contains  (from  left  to  right)  the  date,  the  column  and  row 
for  the  output  location,  and  an  assigned  station  number. 

37 .  The  matrix  of  numbers  that  follows  the  first  record  contains  both 
the  frequency  and  frequency-direction  spectrum  for  the  specified  location  and 
date.  The  first  column  contains  the  frequency  spectrvun  (in  square 
centimeters).  The  top  of  the  column  corresponds  to  the  lowest  frequency.  The 
frequency  values  associated  with  the  energy  values  in  the  first  column  were 
specified  through  questions  GF-9  and  GF-10.  The  other  columns  contain  the 
frequency-direction  spectrum  (in  square  centimeters).  Each  row  corresponds  to 
the  same  frequency  in  the  adjacent  frequency  spectrum.  The  first  column  of 
the  frequency- direction  spectrum  corresponds  to  the  direction  band  at  -90°  +  e 
where  €  is  defined  in  question  GF-12,  and  the  reference  system  is  defined  in 
Figure  8-1.  The  width  of  each  direction  band  is  defined  in  question  GF-11. 
Wave  Characteristics  Output  File 

38.  The  Wave  Characteristics  Output  File  contains  the  energy-based  wave 
height,  peak  spectral  period,  and  mean  spectral  propagation  direction  for  the 
total  energy  spectrum  for  each  specified  output  location  (questions  GF-22  and 
GF-23)  and  each  output  interval  (question  GF-21).  The  values  in  each  record 
have  the  following  definitions:  (from  left  to  right) 

1 .  The  date  (yymraddhhmm) . 

2.  The  column  of  the  output  location. 

3.  The  row  of  the  output  location. 

4.  The  location  identification  number  (station  number). 
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5.  The  energy-based  wave  height  of  the  spectrum  (m) . 

6.  The  peak  spectral  period  (sec). 

7.  The  mean  spectral  propagation  direction  (see  Figure  8-1). 

8. -15.  0. 

Parameter  File 

39.  The  Parameter  File  is  created  by  the  General  File-Building  Routine. 
The  values  in  the  Parameter  File  are  used  to  dimension  variables  in  STWAVE  and 
its  supporting  programs.  The  programs  use  the  FORTRAN  command  "INCLUDE"  to 
include  the  Parameter  File  in  the  programs  during  compilation.  The  Parameter 
File  contains  a  FORTRAN  "PARAMETER"  statement.  The  variables  in  the 
"PARAMETER"  statement  are  defined  below: 

IDMN  -  Number  of  columns  in  the  computational  grid. 

JDMN  -  Number  of  rows  in  the  computational  grid. 

IF  -  Number  of  spectral  frequency  bands. 

lA  -  Number  of  spectral  direction  bands. 

KSST  -  0 

MKST  -  0 

NBPS  -  0 

NDIF  -  0 

ITDM  -  Ntunber  of  output  intervals. 

NDMN  -  Number  of  special  output  locations. 

MODEL  -  2,  specifies  STWAVE  model. 

INDM  -  Number  of  input  data  sets . 

Main  File  Name  File 

40.  The  Main  File  Name  File  contains  the  names  of  the  General  Input 
File  and  the  Bathymetry  File .  The  format  for  the  Main  File  Name  File  is 
provided  below. 


S' 

RECORD  1, 

Free  Format. 

Field  1 

-  Blank . 

b. 

RECORD  2, 

Free  Format. 

Field  1 

-  General  Input  File  Name. 

c . 

RECORD  3, 

Free  Format. 

Field  1 

-  Bathymetry  Data  File  Name 

d. 

RECORD  4. 

Free  Format. 

Field  1  -  Boundary  Condition  Option  Number. 
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41 .  The  Boundary  Condition  File  Name  File  contains  the  name  of  the 
Boundary  Condition  File  generated  by  the  BCGEN,  or  by  the  General  File- 
Building  Routine  (when  conducting  a  subgrid  simulation)  for  STWAVE.  The 
format  for  the  Boundary  Condition  File  Name  File  is  provided  below. 

a.  RECORD  1,  Free  Format. 

Field  1  -  Boundary  Condition  File  Name. 

Post-Processing  File  Name  File 

42.  The  Post-Processing  File  Name  File  contains  the  names  of  the  data 
output  files  generated  by  STWAVE.  The  files  include  the  Wave  Field  Output 
File,  the  Wave  Characteristics  Output  File,  and  the  Wave  Spectra  File.  The 
format  for  the  Post-Processing  File  Name  File  is  provided  below. 

a.  RECORD  1,  Free  format. 

Field  1  -  Name  of  the  ".sea"  file. 

Field  2  -  Name  of  the  ".spe"  file. 

Field  3  -  Name  of  the  ".mtx"  file. 


(See  Part  III,  "Function  to  Run  Programs,"  for  description.) 
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Chapter  9 


HARBOR  WAVE  OSCILLATION  MODEL  (HARBD) 

THEORY  AND  PROGRAM  DOCUMENTATION 

PART  I :  INTRODUCTION 

Background 

1.  Excessive  wave  action  in  harbors  is  caused  by  resonance  or 
inadequate  protection  from  structures  such  as  breakwaters  or  jetties.  Harbor 
resonance  is  the  phenomenon  that  occurs  when  the  natural  period  of  a  harbor  is 
equal  or  close  to  an  incident  wave  period.  The  effects  of  this  wave  activity 
should  be  avoided  or  minimized  in  harbor  planning  and  operation,  since  the 
impact  on  navigation  or  mooring  of  vessels  will  be  adverse  or  will  result  in 
sediment  deposition  or  erosion  within  the  harbor.  This  chapter  documents  the 
harbor  wave  oscillation  model  (HARBD)  developed  at  the  US  Army  Engineer 
Waterways  Experiment  Station  (WES)  Coastal  Engineering  Research  Center  (CERC) 
for  use  in  the  design  and  modification  of  harbors.  The  theoretical  basis  of 
the  model  is  described  in  Chen  (1984,  1986),  and  the  numerical  scheme  of  the 
model  is  described  in  Chen  and  Mei  (1974).  A  description  of  the  theoretical 
basis  of  the  finite  element  method,  which  is  used  in  HARBD,  is  beyond  the 
scope  of  this  chapter.  It  is  recommended  that  the  user  refer  to  an 
introductory  text  pertaining  to  the  finite  element  method  for  a  better 
understanding  of  the  numerical  techniques  used  in  the  model  (Mori  1983). 

2.  A  number  of  numerical  models  have  been  used  to  investigate  the 
effects  of  harbor  resonance.  For  example,  Lee  1969;  Chen  and  Mei  1974;  Yue, 
Chen,  and  Mei  1976;  Berkoff  1976;  Houston  1981;  Lepelletier  1981;  Ganaba, 

Wei ford,  and  Lee  1982;  Behrendt  and  Jonsson  1984;  Skovgaard,  Behrendt,  and 
Jonsson  1984;  Yoshida,  Ijima,  and  Okuzono  1984;  Matsoukis  1985;  and  Chen  1986 
implement  various  numerical  techniques  including  the  ray  method.  Green's 
function  method,  eigen- function  method,  finite  difference  method,  finite 
element  method,  and  hybrid  element  method  (Crawford  and  Chen  1988).  HARBD 
uses  a  hybrid  element  method  in  this  steady-state  model,  based  on  linear  wave 
theory.  The  model  is  used  in  the  study  of  wave  oscillations  in  harbors  and 
wave  scattering  in  the  water  domain  with  boundaries  of  arbitrary  configuration 
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and  variable  bathymetry.  The  effects  of  bottom  friction  and  boundary 
reflection  are  included.  The  bottom  friction  is  assumed  to  be  proportional  to 
flow  velocity  with  a  phase  difference.  The  boundary  reflection  is  formulated 
similar  to  the  impedance  condition  in  acoustics,  and  is  expressed  in  terms  of 
the  wave  number  (2x/L  where  L  is  the  wavelength)  and  the  reflection 
coefficient  of  the  boundary.  A  hybrid  element  method  based  on  a  variational 
principal  is  used  for  the  numerical  solution  (Chen  and  Houston  1987).  The 
model  was  originally  developed  for  harbor  oscillations  (long-period  waves) , 
and  the  general  formulation  was  adapted  for  wind  waves  (short-period  waves)  by 
Houston  (1981) . 

3.  HARBD  has  been  tested  and  compared  with  known  analytical  solutions 
for  a  number  of  cases  and  the  results  are  excellent  (Chen  1984;  Chen  and 
Houston  1987).  It  has  been  applied  in  the  design  or  modification  of  Agat 
Harbor,  Guam  (Farrar  and  Chen  1987);  Kawaihae  Harbor,  Hawaii  (Lillycrop, 
Bratos,  and  Thompson  1990);  Barbers  Point  Harbor,  Oahu,  Hawaii  (Durham  1978); 
and  has  been  recently  applied  to  Maalaea  Harbor,  Maui,  Hawaii.  The  model  was 
Instrumental  in  studying  the  effects  of  entrance  channel  dredging  at  Morro  Bay 
Harbor,  California  (Kaihatu,  Lillycrop,  and  Thompson  1989),  and  analyzing 
harbor  resonance  at  Los  Angeles-Long  Beach  Harbor,  California  (Sargent  1989). 
The  model  was  used  to  plan  wave  protection  at  Fisherman's  Wharf,  San 
Francisco,  CA  (Bottin,  Sargent,  and  Mize  1985);  Green  Harbor,  Massachusetts 
(Weishar  and  Aubrey  1986);  Los  Angeles-Long  Beach  Harbor,  California  (Houston 
1976);  and  to  estimate  the  wave  conditions  in  Indiana  Harbor,  Indiana 
(Clausner  and  Abel  1986).  HARBD  was  compared  to  laboratory  data  collected 
from  the  physical  model  study  of  Barcelona  Harbor,  Buffalo,  NY  (Crawford  and 
Chen  1988)  with  encouraging  results.  The  predictions  of  HARBD  are  currently 
under  further  comparison  with  prototype  and  physical  model  data  collected  from 
recent  studies  of  Barbers  Point  Harbor,  Oahu,  Hawaii. 


Report  Organizatioi 


4.  This  chapter  is  divided  into  five  sections;  Part  II  presents  the 
mathematical  formulations,  assumptions,  and  limitations.  Part  III  defines  the 
input  data  format.  Part  IV  discusses  the  model's  input  data  requirements  and 
finite  element  grid  generation,  and  Part  V  contains  two  illustrative  examples. 
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PART  II:  MATHEMATICAL  FORMULATION 

Assumptions  and  Limitations 

5 .  Proper  application  of  any  model  requires  a  clear  understanding  of 
the  physical  processes  occurring  and  a  comprehension  of  the  capabilities  for  a 
given  model  to  simulate  those  processes.  Model  results  should  provide  a 
realistic  representation  of  the  physical  system  being  modeled. 

6.  The  limitations  of  a  model  define  its  range  of  applicability. 
Assumptions  in  applying  HARBD  include:  (a)  steady- state  (or  time -independent) 
conditions,  (b)  linear  monochromatic  waves,  (c)  small  gradients  in  bathymetry, 
(d)  neglect  of  wave-wave  or  wave-current  interaction,  (e)  neglect  of  wave 
breaking,  (f)  neglect  of  wave  transmission  or  overtopping  of  structures  such 
as  breakwaters  and  jetties,  and  (g)  representation  of  diffraction  around  tips 
of  structures  by  diffraction  around  a  blunt  vertical  wall  with  specified 
reflection  coefficients.  HARBD  is  also  limited  by  the  radial  extent  of  the 
open- water  boundary  surrounding  the  harbor.  The  offshore  area  beyond  the 
open-water  boundary  is  assumed  to  have  a  constant  water  depth  and  no  bottom 
friction;  therefore,  prototype  bathymetry  and  shoreline  configuration  beyond 
the  open- water  boundary  cannot  be  modeled  exactly. 

7.  It  is  crucial  that  the  user  follow  all  specifications  required  of 
the  HARBD  model  in  generation  of  the  finite  element  grid  used  as  input.  The 

input  grid  to  the  HARBD  model  is  unique  from  other  finite  element  models  in 
that  specific  grid  constraints  are  required  for  proper  application. 

Additional  information  regarding  grid  generation  is  given  in  Part  IV  of  this 
chapter . 


Boundary  Value  Problem 

8.  HARBD  uses  a  hybrid  element  method  in  which  a  finite -element 
solution  in  the  interior  region  of  the  harbor  is  matched  to  an  analytical 
solution  in  the  exterior  region.  In  the  interior  region,  HARBD  allows 
arbitrary  depth  (i.e.,  shallow,  intermediate,  and  deepwater  waves),  variable 
geometry,  and  consideration  for  the  effects  of  bottom  friction  and  boundary 
reflection. 
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9.  In  model  formulation  for  arbitrary  depth  water  waves,  the  entire 
water  domain  is  divided  into  near  and  semi-infinite  regions,  A  and  B  , 
respectively.  The  two  regions  are  separated  by  an  artificial  180-deg*  semi¬ 
circular  boundary  9A  as  shown  in  Figure  9-1.  The  near  region  A  is  bounded 
by  a  wall  boundary  flC  and  should  include  the  harbor  and  all  marine 
structures  and  bathymetry  of  interest.  The  semi -infinite  region  B  is  a 
180-deg  semicircular  ring  shape  which  is  bounded  by  3A  and  the  straight 
horizontal  coastlines  along  the  x-axis.  The  region  extends  to  infinity  in  all 
directions,  as  shown  in  Figure  9-1.  The  semi-infinite  region  B  is  assumed 
to  have  a  constant  water  depth  and  no  bottom  friction  (Chen  and  Houston  1987) . 


Figure  9-1.  Definition  sketch  of  a  harbor 


A  table  of  factors  for  converting  non- SI  units  of  measurement  to  SI 
(metric)  units  is  presented  on  page  vii. 
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10.  The  governing  partial  differential  equation  is  derived  through 
application  of  linear  wave  theory  to  the  continuity  and  momentum  equations. 
This  also  assumes  all  dependent  variables  are  periodic  in  time  with  angular 
frequency  u  .  These  steps  yield  the  following  generalized  Helmholtz  equation 
(Chen  1986): 

V  accy^)  *  =  0  (^-1) 

•  c 


where 


The  wave 


V  -  horizontal  gradient  operator 
A  -  complex  bottom  friction  factor 
c  -  wave  phase  velocity  -  i'o/x) 

Cg  -  wave  group  velocity  -  [c/2{l  +  (2<ch/sinh  2Kh) )  ] 
K  —  wave  number,  (2jr/L)  ,  where  L  -  wavelength 
h  -  water  depth 
tft  -  velocity  potential 
w  -  angular  frequency 

number  is  obtained  from  the  dispersion  relation 


<0*  =  gK  tanh  (xh) 


(9-2) 


where  g  -  acceleration  due  to  gravity 

11.  The  complex  bottom  friction  factor  A  is  assumed  proportional  to 
the  maximum  velocity  at  the  bottom  and  is  defined  as: 


A 


1  + 


h  sinh  xh 


exp(iY) 


(9-3) 


where 


i  -  (-1)1/2 

P  -  dimensionless  bottom  friction  coefficient  that  varies  spatially 
a^  -  incident  wave  amplitude 
h  -  water  depth 

K  -  wave  number  2w/L  ,  where  L  -  wavelength 
7  -  phase  shift  between  stress  and  flow  velocity 
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The  effects  of  bottom  friction  do  not  necessarily  need  to  be  included  in  the 
general  solution.  This  is  accomplished  by  setting  «  0  ,  which  results  in 
A  -  1  ,  and  Equation  9-1  reduces  to  an  expression  which  excludes  bottom 
friction. 

12.  Equation  9-1  is  the  field  equation  that  is  solved  for  the  velocity 
potential  ^  .  In  order  to  solve  for  4>  ,  the  boundary  conditions  must  first 
be  established.  Since  the  field  is  separated  into  the  two  regions,  A  and 

B  ,  there  are  two  boundary  conditions  to  establish.  The  two  boundary 
conditions  are:  (a)  along  the  interface  between  the  solid  harbor  boundaries 
aC  and  near  region  A  ,  and  (b)  along  the  interface  between  the  ocean 
boundary  dk  and  the  semi- inf inite  region  B  .  The  goal  is  to  solve  for  the 
velocity  potential  <f)  in  regions  A  and  B  with  the  assumptions  governing 
these  regions. 

13.  The  velocity  potential  does  not  have  a  physical  meaning  in 
engineering  practice.  However,  if  ^  is  obtained  through  Equation  9-1,  it 
can  be  related  to  physical  quantities  such  as  velocities,  pressures,  or  free 
surface  displacement.  The  user  is  referenced  to  Dean  and  Dalrymple  (1984)  for 
the  theoretical  development  of  the  velocity  potential  . 

14.  The  horizontal  flow  velocities  u  and  v  in  the  x-  and  y- 
directions,  respectively,  the  hydrodynamic  pressure  ,  and  the  free  surface 
displacement  C  are  related  to  the  velocity  potential  <l>  by: 

u(x,y,z,t)  =  Af  (9-4) 


v(x,y,z,  t)  =  Af e'^"^  (9-5) 


Pj(x,y.z,t)  =  (9-6) 

C(x,y,  C)  =  ^  (9-7) 

9 
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where  z  - 

t  - 

P  - 
f  - 


vertical  coordinate  with  the  origin  at  the  still-water  surface 
temporal  variable 
water  density 

vertical  dependency  of  the  wave  field  given  as: 


f  = 


cosh  k(z  •*•  h) 
cosh  Kh 


(9-8) 


15.  The  objective  is  to  solve  Equation  9-1  for  the  velocity  potential 
(fi  .  To  accomplish  this,  the  two  boundary  conditions  along  flA  and  3C  are 
needed.  For  the  boundary  condition  along  the  solid  harbor  boundaries  dC 
(Figure  9-1),  the  model  uses  the  impedance  condition  used  in  acoustics  which 
relates  the  flow  velocity  u  ,  hydrodynamic  pressure  ,  and  free  surface 
displacement  f  to  the  velocity  potential  ^  ,  and  is  expressed  as: 


4^  -  o<J>  =  0 

dn 


(9-9) 


and 


a 


IK 


1 

1  *  JC, 


(9-10) 


where  n  -  unit-normal  vector  directed  outward  from  the  fluid  domain 
a  -  dimensional  coefficient  related  to  the  boundary  reflection 
Kj  -  reflection  coefficient  of  the  boundary 
Similar  to  the  friction  coefficient,  when  -  1  ,  then  a  -  0  ,  and 
Equation  9-9  reduces  to  a  zero  velocity  potential  normal  to  the  boundary 
(Sargent  1989).  This  infers  a  perfectly  reflecting  boundary  condition. 

16.  After  the  field  equation  and  the  boundary  condition  along  the  solid 
harbor  boundaries  dC  have  been  specified,  attention  must  be  given  to  solving 
the  "open  ocean"  boundary  3A  .  The  "hybrid”  nature  of  the  solution  method  is 
used  to  solve  Equation  9-1  for  .  Basically,  the  velocity  potential  ^  can 
be  separated  into  several  components.  Once  each  component  is  determined,  its 
relationship  to  the  others  is  used  to  solve  for  4>  . 

17.  For  a  harbor  in  a  semi - inf inite  ocean  with  a  straight  coastline, 
there  are  incident,  reflected,  and  scattered  waves.  The  sum  of  the  velocity 
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potentials  of  these  waves  is  the  velocity  potential  of  the  total  wave  <i>  .  An 
incident  wave  is  assumed  to  arrive  from  infinity.  Water  depth  is  assumed  to 
be  constant  in  the  semi- inf inite  region  B  ,  and  along  the  open  ocean 
boundary  3A  .  It  is  important  to  characterize  the  incident  angle  of  approach 
di  relative  to  the  x-axis  (Figure  9-1).  The  velocity  potential  of  the 
incident  wave  <f>i  can  be  expressed  in  general  terms  as: 

4>j  =  ^  (6 -e^,  (9-11) 


where  6  is  the  wave  angle  of  the  total  wave. 

18.  As  shown  in  Equation  9-11,  a  wave  of  amplitude  a^  ,  angular 
frequency  w  ,  and  wave  number  k  can  be  expressed  in  terms  of  the  velocity 
potential  of  the  incident  wave.  If  the  water  depth  is  constant,  the  reflected 
wave  4)f^  which  originates  in  the  near  region  A  can  easily  be  obtained  for  a 
given  incident  wave  and  a  straight  perfectly  reflecting  coastline.  The 
reflected  wave  <f)  is  equal  to  the  incident  wave  .  The  scattered  wave, 
which  occurs  in  the  semi - inf inite  region  B  ,  is  the  total  wave  less  the 
incident  and  reflected  wave,  i.e., 

4>b  =  4>  -  <t>r  "  (9-12) 


The  scattered  wave  has  a  velocity  potential  given  by: 


4>s  =  X)  ®n  W„(Kr)  cos  (nS) 

n-0 


(9-13) 


where  =  unknown  coefficients 

Hn(»cr)  =  Hankel  functions  of  the  first  order  n 

r,  =  radial  and  angular  variables  in  polar  coordinates 
19.  Since  the  fluid  domain  in  the  semi- inf inite  region  B  is  assumed 
to  extend  to  infinity,  the  radiation  condition  that  all  scattered  waves  must 
behave  as  outgoing  waves  at  infinity  must  be  imposed.  The  velocity  potential 
of  the  scattered  wave  satisfies  this  radiation  condition.  This  condition  is 
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known  as  the  Somraerfeld  radiation  condition  and  is  expressed  mathematically  as 
follows  (Houston  1981): 


lim 


(9-14) 


Solution  Method 


20.  A  method  of  solving  the  boundary  value  problem  must  be  established. 
The  field  equation  (Equation  9-1)  and  the  variable  to  be  solved  for  (velocity 
potential  4>  )  have  been  identified.  The  two  boundary  conditions  in  the  near 
and  semi-infinite  regions,  A  and  B  ,  respectively,  have  been  established. 

In  order  to  solve  for  the  total  velocity  potential  ^  ,  the  components  of  ^ 
have  been  identified  as  the  velocity  potentials  of  the  incident  wave  ,  the 
reflected  wave  near  region,  and  the  scattered  wave  bhe 

semi- inf inite  region.  Since  the  incident  wave  is  known,  the  reflected  and 
scattered  waves  must  be  solved  for  with  the  hybrid  element  method  described  in 
the  following  section. 


Hybrid  Element  Solution  Method 

21.  The  hybrid  element  method  (so  named  because  the  method  involves  the 
combination  of  analytical  and  finite  element  numerical  solutions)  is  used  to 
solve  the  aforementioned  boundary  value  problem  (Equation  9-1).  In  this 
solution,  a  conventional  finite  element  approximation  is  used  in  the  near 
region  A  ,  while  an  analytical  solution  with  unknown  coefficients  is  used  to 
describe  the  semi-infinite  region  B  ,  To  solve  the  boundary  value  problem,  a 
linear  functional  must  be  established  and  minimized.  The  objective  is  to 
construct  an  approximate  solution  to  the  boundary  value  problem  in  terms  of 
the  functional.  A  variation-of -principles  approach  is  used  to  minimize  the 
functional.  Once  the  first  and  second  variations  of  the  functional  are 
calculated,  it  is  a  necessary  condition  that  the  functional  attain  its 
stationary  point.  That  is,  when  the  functional  is  minimized,  the  first 
variation  must  vanish  (Mori  1983) .  A  Euler -Lagrange  formulation  is  used  to 
match  the  boundary  value  problem  between  regions  A  and  B  .  The  following 
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functional  was  constructed  with  the  property  that  it  is  stationary  with 
respect  to  the  first  variation  of  the  velocity  potential; 
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where  <f>i  is  the  incident  wave  velocity  potential,  n  is  a  unit  normal,  and 
the  last  two  integrals  are  line  integrals  at  infinity.  This  functional 
(Equation  9-15)  can  be  rewritten  as  follows: 
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22.  In  the  near  region  A  the  finite  element  method  is  used  to  solve 
the  integral  equation  obtained  from  minimizing  the  functional.  Basically, 
this  is  a  numerical  approximation  technique  that  divides  the  near  region  A 
within  the  bounding  semicircular  domain  3A  into  a  finite  element  mesh  or 
finite  number  of  nonoverlapping  triangular  sub -domains  which  are  called 
elements  (Houston,  Carver,  and  Markle  1977). 

23.  The  objective  is  to  approximate  the  solution  within  each  element  by 

suitable  interpolation  functions  in  terms  of  a  finite  number  of  unknown 
parameters.  The  unknown  parameters  are  the  values  of  field  variable  (f>  at  a 
finite  number  of  coordinate  pairs  called  nodes.  These  nodes  are  related  to 
adjacent  nodes  by  element  connectivity  (three  nodes  per  triangular  element) . 
The  relationships  for  individual  elements  are  combined  into  a  system  of 
equations  for  all  unknown  parameters.  The  local  water  depth  h  and  bottom 
friction  factor  are  defined  at  the  element  centers.  The  reflection 
coefficients  are  specified  at  boundary  elements,  which  are  defined  as  a 
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subset  of  the  element  data.  Once  the  physical  geometry  of  the  finite  element 
mesh  is  defined,  a  series  of  values  for  wave  period  T  ,  wave  direction  $  , 
and  wave  amplitude  a^  can  be  supplied  as  input  to  the  model  (Sargent  1989) . 

24.  In  the  semi- inf inite  region  E  outside  the  basin,  the  velocity 
potentials  are  solved  analytically  in  terms  of  unknown  coefficients  0^  .  The 
region  is  considered  to  be  a  single  super-element  with  a  shape  function  given 
by  Equation  9-13,  the  velocity  potential  of  the  scattered  wave  ^3  .  The 
shape  functions  are  used  to  evaluate  the  integrals  in  Equation  9-16  and  the 
functional  is  extremized  with  respect  to  the  unknowns.  A  set  of  linear 
algebraic  equations  is  then  obtained.  The  infinite  series  given  by  Equation 
9-13  must  be  truncated  at  some  finite  extent.  The  number  of  terms  to  maintain 
is  dependent  on  the  incident  wavelength  such  that  the  addition  of  further 
terms  is  no  longer  sensitive  to  the  solution  for  ^3  .  The  solution  of  the 
boundary  value  problem  is  now  reduced  to  the  solution  of  N  linear  algebraic 
equations  for  N  unknowns  (where  N  is  the  sum  of  the  number  of  nodes  in  the 
finite  element  mesh  of  the  near  region  A  plus  the  number  of  unknowns  in  the 
truncated  series  in  Equation  9-13)  (Houston  1981). 

25.  Upon  solving  the  system  of  linear  algebraic  equations,  the 
conditions  between  the  regular  elements  in  the  near  region  A  and  the  super¬ 
element  in  the  semi- inf inite  region  B  will  be  matched.  To  solve  the  system 
of  linear  algebraic  equations,  the  equations  are  assembled  into  element 
matrices : 

m  {«!»)  -  iCJJ  (9-17) 

NxN  Nxl  Nxl 


where  [K]  -  the  complex  coefficient  matrix,  or  [K]  is  referred  to  the 
element  stiffness  matrix  in  structural  mechanics,  I  V*  1  ”  the  combination  of 
nodal  and  coefficient  unknowns  which  define  a  total  unknown  vector,  and  (Q  I 
-  the  load  vector.  The  coefficient  matrix  [K]  is  symmetric.  The  numbering 
of  the  nodes  in  the  finite  element  mesh  of  the  near  region  A  and  the 
arrangement  of  the  unknown  coefficients  in  I  V*  I  determine  the  bandwidth  of 
the  matrix  [K]  The  bandwidth  is  the  largest  difference  in  node  numbers 
between  two  nodes  of  the  same  element  (Chen  and  Mei  1974) . 

26.  Computer  capabilities  often  limit  solving  a  large  system  of 
algebraic  equations  which  arise  from  using  the  finite  element  method.  The 
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symmetric  complex  coefficient  matrix  [K]  is,  in  general,  large,  sparse,  and 

NxN 

banded.  Therefore,  it  is  stored  and  manipulated  in  the  computer  in  a  packed 

form.  This  saves  a  substantial  amount  of  storage  and  computer  processing 

time.  The  packed  form  is  chosen  to  be  a  rectangular  array  [K]  (  N  variables 

NxB 

in  length  and  the  semi -band  in  width,  B  )  as  shown  in  Figure  9-2.  Only  the 

elements  of  [K]  on  and  above  the  diagonal,  and  within  the  bandwidth  need  to 
NxN 

be  stored  in  the  rectangular  packed  matrix  [K]  ,  which  contains  zeros  in  its 

NxB 

lower  triangular  part  as  shown  in  Figure  9-2.  The  rectangular  packed  matrix 
is  solved  using  Gaussian  elimination.  The  solution  time  is  proportional  to 
the  number  of  unknowns  (nodes)  multiplied  by  the  bandwidth  squared. 


Figure  9-2.  Rectangular  packed  form  of  storage  for  [K] 

NxN 

27.  With  the  solution  for  the  velocity  potentials  of  the  reflected  and 

scattered  waves  and  ,  respectively,  accomplished,  and  knowing  the 

incident  wave  ,  the  total  velocity  potential  <f>  can  be  solved  for  and 

substituted  into  the  governing  field  equation,  Equation  9-1.  The  solution  is 
normalized  with  respect  to  an  incident  wave  of  unit  amplitude.  The  absolute 
value  of  the  resulting  complex  velocity  potential  ^  at  each  node  is 
represented  as  an  amplification  factor  (i.e.,  the  ratio  of  wave  height  at  a 
particular  node  to  incident  wave  height)  and  corresponding  phase  angle. 

28.  The  hybrid  element  method  is  a  steady-state  solution  of  the 
boundary  value  problem.  The  response  of  a  harbor  to  an  arbitrary  forcing 
function  can  be  determined  within  the  framework  of  linear  wave  theory.  For 
example,  an  arbitrary  incident  wave  in  the  semi- inf inite  region  can  be  Fourier 
decomposed  as  follows: 
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where  -  incident  wave  amplitude 

a(w)  -  amplitude  of  frequency  component  w 
p(w)  -  phase  angle 

If  tj  is  the  response  amplitude  at  any  point  inside  the  harbor  due  to  an 
incident  plane  wave  of  unit  amplitude  and  frequency  w  ,  then  the  response  of 
the  harbor  to  the  arbitrary  incident  wave  a^Ct)  is  given  by 
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where  the  operation  R,[]  takes  the  real  part  of  the  bracketed  quantity. 
Therefore,  as  soon  as  ij  is  known  for  all  phase  angles  w  ,  the  harbor 
response  to  an  arbitrary  incident  wave  can  be  calculated  (Houston,  Carver,  and 
Markle  1977). 
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PART  III:  DEFINITION  OF  INPUT  DATA  FORMAT 


29.  The  input  data  set  format  was  designed  to  resemble  the  format 
required  by  the  series  of  computer  models  released  by  the  US  Army  Engineer 
(USAE)  Hydrologic  Engineering  Center.  Since  Corps  of  Engineers  personnel  are 
familiar  with  this  structure,  it  was  chosen  in  an  effort  to  reduce  the  amount 
of  time  necessary  to  learn  this  system.  The  general  format  of  the  input  data 
set  records,  where  a  record  refers  to  one  line  of  data,  is  presented  below: 

a.  Each  record  is  divided  into  10  fields  containing  8  columns 
each. 

b.  Field  1,  columns  1  through  8,  contains  a  mnemonic 
identification  label  that  describes  the  purpose  or  function  of 
each  record. 

c.  Fields  2  through  10  contain  data  that  may  be  real,  integer,  or 
character  in  type.  Integers  must  be  right- justified.  Real 
numbers  must  also  be  right- justified  if  the  decimal  point  is 
omitted.  Character  data  do  not  need  to  be  right-  or  left- 
justified. 

d.  Array  data,  such  as  depths,  are  read  with  a  group  of  statements 
that  is  performed  repeatedly  (DO),  or  Implied  DO  loops.  A 
label  is  not  required  for  each  record  containing  array  data. 
However,  a  general  specification  record,  such  as  BATHSPEC, 
which  defines  bathymetric  attributes,  must  precede  that  array. 

30.  Spelling  of  record  identification  labels  and  alphanumeric  variables 
is  important.  Misspelled  entries  will  result  in  either  recognized  error 
conditions  that  force  the  model  to  abort  execution,  or  bypassing  of  desired 
user-defined  operations,  such  as  bathymetric  changes. 

31.  Certain  records  and  variables  have  been  assigned  default  values  in 
the  model  for  minimizing  input  data  and  computer  resources.  Thus,  not  all 
input  data  records  will  be  needed  for  each  application,  and  only  those  records 
pertinent  to  the  simulation  or  required  by  the  model  should  be  included. 
Default  values  are  representative  of  those  chosen  in  previous  studies 
performed  by  the  WES/CERC  staff.  Although  these  quantities  may  not  be 
applicable  to  all  studies,  they  can  serve  as  a  guide  when  selecting 
replacement  values. 

32.  Default  values  are  processed  when  the  record  field  corresponding 
to  that  variable  is  blank.  Hence,  the  user  must  be  careful  when  leaving 
fields  blank  in  a  record;  blank  fields  will  not  necessarily  result  in  a 
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variable  being  assigned  a  value  of  zero.  These  variables  and  their  respective 
default  values  are  noted  in  Appendix  9 -A.  The  following  discussion  pertains 
to  the  general  format  of  the  input  records  given  in  Appendix  9 -A. 

33.  Each  record  is  presented  in  a  standardized  tabular  format  and  has 
as  its  heading  the  mnemonic  identification  label  or  name,  with  a  brief 
description  of  its  function.  Following  its  name,  the  record  has  an 
abbreviated  note  docximenting  whether  it  is  required  for  a  simulation.  These 
abbreviations  have  the  following  definitions: 

(Req)  Record  or  variable  is  required  for  each  simulation. 

(Opt)  Record  or  variable  is  optional.  Omitting  this  item  results 
in  either  the  default  value  being  used  or  the  defined 
operation  not  being  performed. 

For  example,  record  BATHSPEC,  presented  in  Appendix  9-A,  contains  the  note 
(Req) ,  meaning  that  this  record  must  reside  in  the  input  data  set  for  each 
simulation.  Record  CHNGBATH  contains  the  note  (Opt) ,  meaning  this  record  is 
optional  and  is  only  used  when  changes  to  the  bathymetric  data  are  desired. 

34.  Input  variables,  presented  in  column  2  of  each  table,  are 
referenced  to  their  respective  record  fields  shown  in  column  1.  Generally, 
data  for  each  variable  occupy  a  single  8-column  data  field.  However, 
variables  assigned  titling  or  formatting  Information  can  occupy  several 
fields . 

35.  Variable  attributes  are  presented  in  columns  3  through  6  of  each 
table.  Valid  data  types  are  listed  in  column  3,  and  can  be  real.  Integer,  or 
alphanumeric.  Abbreviations  presented  in  this  column  are  described  below: 

Char*16  Alphanumeric  character  string  containing  up 

to  16  characters 

Char*8  Alphanumeric  character  string  containing  up 

to  8  characters 

Integer  Integer  data 

Real  Real  (floating  point)  data 

36.  Column  4  of  each  table  defines  whether  the  respective  variable  must 
be  assigned  a  value.  Abbreviations  listed  in  this  column  have  meanings 
identical  to  those  for  the  records.  Default  values  are  listed  in  column  5.  A 
blank  entry  in  this  column  denotes  that  the  respective  variable  is  not 
assigned  a  default  value. 
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37.  Column  6  of  each  table  lists  the  variables'  permitted  data  type  or 
all  valid  character  strings.  Variables  having  integer  or  real  data  types  are 
specified  with  the  following  notation: 

A  Alphanumeric  values 

+R  Positive  real  values 

R  Positive,  zero,  or  negative  real  values 

+I  Positive  integer  values 

I  Positive,  zero,  or  negative  integer  values 

38.  Variable  definitions  are  listed  in  column  7  of  each  table. 
Variables  whose  quantities  are  unit -dependent  contain  a  reference  to  that 
variable  designating  its  system  of  units.  For  example,  variable  WDATUM  is 
assigned  a  value  having  units  defined  by  variable  BUNITS .  Variables  defining 
input  data  units,  and  on  which  record  they  reside,  are  presented  below. 

Variable  Record  Definition _ 

BUNITS  BATHSPEC  Bathymetry/topography  data 

GUNITS  GRIDSPEC  Numerical  grid  data 

SUNITS  GENSPECS  Model  computations  and  output 
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PART  IV;  DISCUSSION  OF  THE  INPUT  DATA  REQUIREMENTS 


39.  Considerable  effort  is  required  by  the  user  to  prepare  HARBD  for 
execution.  Care  should  be  taken  to  prepare  all  required  information  to 
minimize  any  syntax,  compilation,  or  other  errors  during  execution  of  this 
code.  Since  each  application  to  a  site-specific  project  is  unique,  the  type 
of  input  data  required  for  each  study  will  vary.  In  this  discussion  of  model 
input,  data  have  been  divided  into  four  categories  to  present  model  capabil¬ 
ities  and  data  requirements.  These  categories  are: 

a.  Model  control  specifications. 

b.  Grid  description. 

c.  Physical  characteristics. 

d.  Output  specifications. 

40.  Table  9-1  presents  HARBD  input  data  records  pertaining  to  each 
category.  A  record  refers  to  one  line  of  data,  and  each  record  begins  with  a 
mnemonic  character  string  to  identify  one  record  type  from  another.  Record 
format  and  detailed  specification  for  each  record  are  presented  in  this 
chapter.  While  reading  Part  IV,  the  user  will  find  it  beneficial  to  refer  to 
Appendix  9- A. 


Model  Control  Specifications 

41.  The  model  control  parameters  are  contained  in  the  GENSPECS  record. 
Record  GENSPECS  is  used  to  specify  the  general  title  of  the  simulation  (TITLE) 
and  the  system  of  units  (SUNITS)  used  for  model  computations  and  displaying 
model  results.  Variable  names  are  given  in  parentheses.  Additional  titles 
may  be  selected  for  specific  input  data  records.  Although  this  information  is 
optional,  it  can  be  very  helpful  when  reviewing  a  series  of  simulations.  A 
title  should  specifically  state  data  attributes,  such  as  data  source  or 
collection  date,  to  differentiate  it  from  data  used  in  other  simulations. 

42.  Model  output  is  displayed  in  either  English  or  metric  units. 
However,  the  user  can  specify  a  different  system  of  units  for  the  input  data. 
For  example,  the  user  can  supply  bathymetry  data  in  units  of  feet  or  meters. 
HARBD  will  convert  the  input  data  into  the  necessary  system  of  units. 
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Table  9-1 

Input  Data  Set  Records 


Cateeorv 

Record  Name 

Model  Control  Specifications 

GENSPECS 

Grid  Description 

GRIDSPEC 

GRIDFORM 

Physical  Characteristics 

BATHS PEC 
CHNGBATH 
WAVCOND 
CONVERG 

Output  Specifications 

PRWINDOW 

PRNODE 

PRNODNUM 

PRBASIN 

PRBNELEM 

Finite  Element  Grid  Description 


43.  The  most  difficult  and  time-consuming  procedure  in  preparing  HARBD 
for  a  simulation  is  generating  the  finite  element  grid.  The  model  is 
extremely  sensitive  to  inaccuracies  in  the  specific  requirements  of  the  unique 
HARBD  finite  element  grid.  Great  care  should  be  taken  in  generation  and 
application  of  the  input  grid  to  HARBD,  Guidelines  for  correctly  generating 
the  finite  element  grid  are  given  in  this  section.  For  clarity,  the  case  of  a 
simple  rectangular  harbor  with  a  finite  element  mesh  overlay,  as  shown  in 
Figure  9-3,  will  serve  as  an  example. 

44.  In  generating  a  finite  element  mesh  for  the  harbor,  the  x-axis  is 
selected  to  generally  follow  the  coastline  of  the  semi- inf inite  region  B  . 

The  origin  is  placed  at  the  harbor  entrance  and  the  positive  y-axis  is  defined 
pointing  offshore.  A  180-deg  semicircular  ocean  boundary  3A  is  drawn  on  the 
positive  y-plane  to  divide  the  water  domain  into  the  semi- inf inite  region  B 
and  the  near  region  A  .  The  near  region  must  include  the  harbor  and  all 
bathymetry  of  interest,  marine  structures,  and  the  coastline. 

45.  A  mesh  of  triangular  elements  is  then  used  to  subdivide  the  region 
N  .  For  the  most  accurate  results,  the  mesh  spacing,  although  arbitrary, 
should  not  change  too  rapidly  and  should  not  be  greater  than  one -sixth  of  the 
wavelength  inside  the  harbor.  The  wavelength  can  be  determined  from  linear 
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Figure  9-3.  A  simple  rectangular  harbor  and  finite  element  mesh 


888 


wave  theory  based  on  the  minimum  wave  period  to  be  tested  and  the  depth  inside 
the  harbor  basin.  The  method  is  given  in  the  Shore  Protection  Manual  (SPM 
1984) .  It  is  also  required  that  the  elements  along  dk  have  equal  spacing 
and  that  each  element  along  the  boundaries  dC  in  near  region  A  have  only 
one  side  on  the  boundary. 

46.  The  user  should  refer  to  Figure  9-4  to  further  clarify  the 
following  explanation  of  the  required  numbering  schemes  for  HARBD  finite 
element  grids.  A  listing  of  the  input  data  set  of  Figure  9-4  is  given  in 
Appendix  9-B.  Node  numbering  is  required.  Each  node  is  assigned  an  integer 
value  ranging  from  one  to  NNOD,  where  NNOD  is  the  total  number  of  nodes.  The 
largest  node  numbers  must  be  located  along  the  semicircular  boundary  flA  in  a 
specified  sequence.  The  largest  node,  NNOD,  must  be  located  at  the 
intersection  of  the  semicircular  boundary  3A  and  the  negative  x-axis.  The 
nodes  along  dA  must  sequentially  decrease  by  one  from  NNOD  advancing  to  the 
next  node  in  a  clockwise  direction  (Figure  9-4).  The  total  number  of  nodes 
along  the  semicircular  boundary  SA  defines  variable  NODR.  For  the  nodes 
which  do  not  lie  along  3A  ,  the  nodal  numbering,  although  arbitrary,  should 
minimize  the  matrix  bandwidth,  which  is  the  incremental  difference  of  values 
assigned  to  adjacent  nodes.  This  is  accomplished  by  numbering  the  nodes  in  a 
semicircular  manner,  starting  from  the  back  of  the  harbor.  The  computational 
time  required  by  HARBD  is  strongly  dependent  upon  the  bandwidth  of  the  grid. 

47.  Along  with  the  assignment  of  a  node  number  are  the  corresponding  x- 
and  y-  coordinates  of  each  node.  The  coordinate  system  must  be  in  compliance 
with  the  requirement  that  the  origin  be  located  at  the  harbor  entrance  and  at 
the  center  of  the  180-deg  semicircular  boundary  (Figure  9-3).  The  y-axis  is 
positive  offshore. 

48.  Each  triangular  element  is  also  assigned  a  sequential  number. 
Element  numbering  is  arbitrary  and  bears  no  relationship  to  the  nodal 
numbering.  Each  element  is  assigned  a  unique  integer  value  ranging  from  one 
to  NELE,  where  NELE  is  the  total  number  of  elements. 

49.  The  three  nodes  which  define  a  triangular  element,  or  nodal 
connectivity,  must  also  be  recorded.  Nodal  numbers  for  each  element  must  be 
recorded  in  a  counterclockwise  order.  In  addition,  those  elements  that  are 
located  along  a  boundary  must  meet  the  specification  that  the  first  two  nodes 
on  the  boundary  be  recorded  first,  in  a  counterclockwise  order.  A  depth  and 
bottom  friction  coefficient  are  also  assigned  to  each  element. 
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50.  The  elements  located  along  the  boundary  in  near  region  A 
(boundary  elements)  are  then  recorded  in  the  following  manner.  The  required 
information  includes  sequential  number,  boundary  element  number,  and 
reflection  coefficient  of  the  boundary  at  that  location.  Boundary  reflection 
coefficients  are  chosen  through  methods  given  in  the  SPM  (1984). 

51.  Records  in  Appendix  9-A  which  control  the  finite  element  grid  are 
GRIDSPEC  and  GRIDFORM.  Selection  of  the  finite  element  grid  type  is 
controlled  by  variable  GRTYPE  on  record  GRIDSPEC.  HARBD  permits  an  x-  y- 
Carteslan  system  with  triangular  elements  only  (GRTYPE  -  TRIANG) . 

52.  Variable  GUNITS  on  record  GRIDSPEC  controls  the  system  of  units  for 
the  finite  element  grid.  Valid  units  are  feet  and  meters.  HARBD  will  convert 
the  data  to  the  system  of  units  for  computations  (SUNITS)  internally. 

Variables  NNOD  and  NELE  specify  the  number  of  nodes  and  ele^mr  on  the 
numerical  grid,  respectively.  Variables  NODR  and  NELB  spe"  fy  h-.  number  of 
nodes  along  the  semicircular  boundary  3A  and  the  number  of  boundary  elements 
in  near  region  A  ,  respectively.  NBAND  specifies  the  grid  bandwidth,  or 
largest  incremental  difference  of  two  adjacent  nodes.  The  file  name 
containing  the  input  data  is  specified  with  variable  GRNAME. 

53.  The  GRIDFORM  record  is  used  to  specify  formats  for  reading  in  the 
input  grid.  GFORMl  specifies  the  format  for  reading  the  node  and 
corresponding  x-  and  y-  coordinates.  GF0RM2  specifies  the  format  for 
reading  the  element,  nodal  connectivity  (node-1,  node-2,  node-3),  depth,  and 
friction  coefficients.  Finally,  GF0RM3  specifies  the  format  for  reading  the 
sequential  number  of  the  boundary  element,  boundary  element  number,  and 
reflection  coefficient.  The  default  formats  are  documented  in  Table  9-2. 

54.  Various  methods  to  generate  an  appropriate  and  accurate  grid  have 
been  investigated.  Early  methods  centered  around  manual  generation,  which  was 
extremely  laborious,  inefficient,  and  economically  inadequate.  For  a  given 
harbor  and  accompanying  bathymetric  chart,  the  finite  element  mesh  was  drafted 
over  the  entire  water  domain  inside  the  harbor  and  extended  seaward  of  the 
harbor  entrance.  Each  node  and  element  was  hand  numbered  in  sequential  order 
and  the  x-  and  y-  coordinates  of  each  nodal  point  were  then  digitized.  For 
each  element,  the  element  number,  nodal  connectivity,  depth,  and  bottom 
friction  coefficient  were  entered  into  a  file.  The  elements  which  lay  along 
the  harbor  boundaries  were  also  recorded  and  assigned  a  boundary  reflection 
coefficient.  Errors  in  numbering  .schemes  were  corrected  through  countless 
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Table  9-2 

Input  Sequence  for  Array  Data 


Sequence 


Description 


node,  x-coor. ,  y-coor. 


READ(LUIN*,GF0RM1)(J,X(J)  ,Y(J)  ,J-1,NN0D) 
GFORMl-  (3(I6.2F10.2)) 


element,  nodel,  node2,  node3, 
depth,  friction  coef. 


READ ( LUIN , GF0RM2 ) ( J , ( I CON (K , J ) , K-1 . 3 ) , 

D(J) ,FRIC(J) ,J-1,NELE) 
GF0RM2-  (2(4I6,F8.2,F8.4)) 


sequential  boundary  element,  READ(LUIN,GF0RM3) (J , 1ELB(J ) ,REFL(J) , J-1 ,NELB) 
element,  reflection  coef.  GF0RM3-  (5(215 , F5 . 2) ) 


*LUIN  is  the  logical  unit  number  for  reading  input  data. 


iterations  of  plotting  the  entire  grid.  The  time  required  to  perform  grid 
generation  for  a  10, 000 -element  grid  was  approximately  6  months. 

55.  Several  attempts  were  made  to  automate  finite  element  grid 
generation  for  HARBD.  These  codes  were  developed  for  various  systems  such  as 
a  mainframe  VAX,  personal  computers,  and  workstations  using  Computer-Aided 
Drafting  and  Design  software.  Although  these  methods  alleviated  some  of  the 
manual  labor,  none  were  satisfactory  for  use  with  HARBD.  Several  automated 
finite  element  grid  generation  codes  have  been  developed  in  recent  years. 

CERC  currently  implements  a  finite  element  grid  generation  code  developed  at 
the  Oregon  Graduate  Institute  by  Dr.  Antonio  Baptista  and  Mr.  Paul  Turner. 

The  code  is  workstation-based  and  has  resolved  most  of  the  intensive  labor  in 
grid  generation  for  HARBD. 


Physical  Characteristics 


Bathymetry 

56.  Each  element  must  be  assigned  a  water  depth  and  bottom  friction 
coefficient.  Bathymetry  data  are  referenced  relative  to  an  arbitrary  datum. 
Typically,  the  map  datura  from  which  the  depths  are  taken  is  used.  Water 
depths  are  input  as  positive  values. 
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57.  One  BATHSPEC  record  is  required  for  defining  tide  level  changes  and 
the  constant  water  depth  in  the  semi-infinite  region  B  .  Variable  BUNITS 
defines  the  units  for  bathymetric  data.  Valid  units  are  feet  or  meters. 

58.  Grid-wide  adjustments  to  water  depths  can  be  made  with  variable 
WDATUM.  The  value  assigned  to  this  variable  is  added  to  all  element  depths. 
Since  these  elements  have  positive  values,  positive  WDATUM  values  produce 
deeper  depths . 

59.  The  constant  depth  value  in  the  semi -infinite  region  B  must  be 
specified  with  variable  FARD.  In  a  prototype  situation,  the  water  depth  in 
the  semi -infinite  region  is  spatially  variable.  For  HARBD  implementation, 

FARD  should  be  chosen  as  the  maximum  water  depth  along  the  semicircular 
boundary  3N  . 

60.  Changes  to  the  bathymetry  can  also  be  made  to  individual  elements, 
or  a  group  of  elements  with  record  CHNGBATH.  This  record  allows  the  user  to 
quickly  change  values  assigned  to  element  depths  (using  variable  BATH)  without 
editing  the  grid  file  itself.  It  should  be  noted  that  (a)  values  of  the 
variable  BATH  on  the  CHNGBATH  record  are  assumed  to  have  units  consistent  with 
those  selected  for  bathymetry  (i.e.,  variable  BUNITS  on  record  BATHSPEC),  and 
(b)  WDATUM  is  not  applied  to  variable  BATH.  Variables  NELSTR  and  NELEND 
specify  the  starting  and  ending  element  numbers  whose  depth  value  should 
change  to  BATH,  respectively.  More  than  one  CHNGBATH  record  is  permitted. 

Wave  conditions 

61.  Each  simulation  requires  wave  information  in  deep  water  (i.e.,  the 
deepwater  wave  amplitude,  direction,  and  period). 

62.  A  WAVCOND  record  is  required  to  define  each  of  the  deepwater  wave 
conditions  to  be  simulated.  One  WAVCOND  record  is  required  for  each  wave 
condition  to  be  simulated,  and  multiple  wave  conditions  can  be  processed  in 
one  simulation.  Simulations  are  usually  limited,  however,  to  5-10  wave 
conditions  grouped  together  in  a  logical  manner. 

63.  Variables  HDEEP,  TDEEP,  and  ZDEEP  specify  the  deepwater  wave 
amplitude,  period,  and  angle,  respectively.  HDEEP  is  used  only  to  calculate 
friction  terms.  If  HDEEP  is  set  to  0,  HARBD  will  generate  a  value  for  HDEEP 
for  each  wave  to  be  simulated.  It  is  suggested  that  HDEEP  be  set  to  0.  TDEEP 
is  the  incident  wave  period  in  seconds.  ZDEEP  is  the  angle  in  degrees 
measured  counterclockwise  from  the  positive  x-axis.  For  example,  if  an 
incident  wave  propagates  from  the  negative  to  positive  x-axis,  the  incident 
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wave  angle  is  0  deg.  If  the  wave  propagates  from  the  positive  to  negative  y- 
axis,  the  incident  wave  angle  is  270  deg. 

Convergence  record 

64.  The  only  variable  on  record  CONVERG  is  REFLEC.  REFLEC  is  the 
reflection  coefficient  specified  along  the  infinite  coastlines  in  the 
region  B. 

Output  Specifications 

65.  HARBD  generates  an  output  listing  containing  a  summary  of  the  input 
data  set  for  every  simulation.  Error  and  warning  diagnostic  messages  are  also 
contained  in  this  listing.  A  sample  output  listing  containing  a  summary  of 
the  input  data  set  is  presented  in  Figure  9-5. 

66.  Each  record  is  summarized  in  tabular  form  with  a  heading  containing 
its  record  identification  label  followed  by  a  brief  description  of  that 
record's  function.  A  table  is  composed  of  each  variable's  name,  a  description 
of  that  variable  (including  its  units,  when  applicable),  and  an  error 
diagnostic  note. 

67.  HARBD  contains  error  diagnostic  features  that  Inspect  an  input  data 
set  for  possible  errors.  These  features  Include  (a)  comparing  an  input  value 
against  a  range  of  quantities  that  are  representative  for  that  variable,  (b) 
checking  for  misspelled  character  data,  and  (c)  checking  for  missing  data. 

The  error  diagnostic  note  can  be  assigned  one  of  three  character  strings: 

(a)  "FATAL"  for  errors  where  the  model  cannot  execute  given  the  value 
supplied,  (b)  "WARN"  for  data  that  are  outside  the  range  of  values  typically 
selected  for  that  variable,  and  (c)  a  null  string  for  Instances  where  an  error 
condition  has  not  been  identified.  Although  this  model  contains  error 
diagnostic  capabilities,  the  user  should  thoroughly  inspect  the  input  data 
summary  to  insure  that  the  data  are  correct. 

68.  The  PRWINDOW  record  is  used  to  specify  the  amount  of  information  to 
be  printed  from  a  simulation.  Variable  WPRGRD  specifies  printing  of  the 
entire  input  grid.  The  options  are  YES  or  JiQ.  The  default  value  is  IJQ.  It 
should  be  noted  that  HARBD  grid  files  can  be  extremely  large.  Once  the  input 
grid  has  been  checked,  it  is  unnecessary  to  print  the  file  repeatedly. 

69.  Variable  WPRNOD  on  record  PRWINDOW  is  used  to  select  printing  of 
the  solution  at  node  locations  throughout  the  harbor.  The  options  are  to 
print  ALL  (solution  ovhr  the  entire  grid),  SELECT  specific  nodes  of  interest. 
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COASTAL  MOOCLlllC  STS1CM  (CMS):  HAfiO  V  (  K  S  1  0  M  1.0 

-  NASO  •  NAtOD  MANUAL  CXAMAlE  MOOUN  - 

*••••  CENSPCCS  CARD:  SPECIFICATION  Of  TITLE  ANO  CEMERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES; 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

METRIC 

• 

•«•••  GRIDSPEC  CARO:  SPECIF ICAI ION  OF  TMC  FINITE-ELEMENT  CttO 

-  SAMPLE. OAT 

VARIABLE 

DESCRIPTION  OF  LISACE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  Of  USAGE: 

VALUC ; 

MOUS: 

CRTTPE 

TYPE  OF  FINITE-ELEMENT  GRID 

TRIANC 

•  OUNITS 

SYSTEM  Of  UNITS  USED  FOR  THE  GRID 

METRIC 

NNOO 

NUMBER  OF  GRID  NODES 

fl6 

*  ««l£ 

HUMBER  OF  GRID  ELEMENTS 

llfi 

MOOR 

NLM8ER  OF  MODES  ON  SEMICIRCULAR  BOUN  19 

•  NEL8 

NLiMBER  Of  BOUNDARY  ELEMENTS 

34 

N6AND 

BANDUtOTN  OF  GRID 

2\ 

•  RADIUS 

RADIUS  OF  SEMICIRCLE 

2.00 

PRWINOOU  CARO:  SPECIFICATION  OF  THE  MODEL  OUTPUT 

VARIABLE 

OESCtlPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUC: 

NOTES: 

ypRNOO 

PRIMTING  OF  MODAL  SOLUTIONS 

SELECT 

•  MAXMOD 

SPECIFIED  MAX  NIRIBER  OF  OUTPUT  NODES  3 

NGOOUT 

NUMBER  OF  MOMS  SCLCCTEO  FOR  OUTPUT 

3 

*  MPBBSM 

KMBU  OF  SPECIFIED  BASINS 

2 

MAXBSN 

SPCCIFIEO  MAXIFBJN  NUMBER  OF  BASINS 

2 

•  MAXEU 

SPECIFIED  MAX  ELEMENTS  IN  AMY  BASIN  3 

NPtOOF 

PBIRTIMC  OF  COEfflClEMT  SOLUTIONS 

TES 

•  UPtCBD 

PtlHTIMG  OF  FINITE  ELEMENT  OID 

TES 

BASIM  • 

HUMBER  OF  ELEMENTS 

•  BASIN 

•  HLR9EB  OF  ELEMENTS 

1 

1 

2 

3 

UAVCONO  CA9CD-.  HUMBER  OF  WAVE  CONDITIONS:  1 

WAVE 

CONDITION  HUMBER:  1 

VARIABLE 

DESCRIPTION  Of  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOtES: 

NOEEP 

DEEPWATER  WAVE  NCIGMT 

0.05 

•  IMfP 

WAVE  PERIOD 

4.29 

20EEP 

OlEPUATCfi  WAVE  ANCLE  220.00 

COASTAL  MODELING  ST 

STEM  < 

CMS):  HARO  .  VERS! 

ION  1.0 

•••**  BATHSPEC  CARO:  SPECIFICATION  0  BATMTMETRY/TOPOCRAPNV  • 

VARIABLE 

DESCRIPTION  OF  LfSAGE; 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE : 

VALUC: 

NOIES: 

BUNITS 

FARO 

SYSTEM  Of  LM1TS  FOR  DEPTH  DATA 
WATER  DEPTH  OF  FAR  REGION 

METERS 

10.128 

•  HDATUM 

DATIRI  FOR  WATER  DEPTHS 

0.00 

HUMBER  Of  ELEVATION  CKAMGCS  * 

0 

VARIABLE 

DESCRIPTION  \i  . 

VALUE; 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE  : 

NCHS 

RCFIEC  REFt.  COIfF.  *  ■>  f ».  iOASI  SNORT  1.00000 


***  INPUT  PROCESSING  COMPLETED: 

FATAL  ERRORS*  0  UARNlNCS^  0 


Figure  9-5. 


Sample  output  listing 
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or  print  NONE  of  the  nodal  information.  The  default  value  is  ALL.  Again, 
file  sizes  may  be  extremely  large  for  printing  the  solution  over  the  entire 
grid.  If  the  SELECT  option  is  specified,  a  PRNODE  record  must  follow  the 
PRWINDOW  record.  Variable  NODOUT  on  record  PRNODE  is  used  to  specify  the 
number  of  specified  nodes  for  output.  An  array  of  the  specific  node  numbers 
for  output,  OUTNOD,  is  then  read  from  PRNODNUM  records  following  the  PRNODE 
record. 

70.  Variable  WPRCOF  on  record  PRWINDOW  is  used  to  select  printing  of 

the  unknown  coefficients  which  were  solved  for  in  the  calculation  of  the 
velocity  potential  of  the  scattered  wave  in  Equation  9-14.  The  options 

are  YES  or  NO.  The  default  value  is  YES . 

71.  Variable  WPRBSN  on  record  PRWINDOW  is  used  to  select  calculation 
and  printing  of  the  solution  at  specified  output  "basins”  throughout  the 
harbor,  rather  than  the  entire  grid.  A  basin  is  defined  as  an  area  comprised 
of  a  specified  number  of  elements  in  which  the  mean  value  of  the  velocity 
potential  for  the  elements  is  calculated.  The  total  number  of  output  basins 
selected  define  variable  WPRBSN.  Obtaining  mean  values  for  various  output 
locations  throughout  the  harbor  is  useful  in  investigating  the  wave  response 
in  specific  locations  of  interest.  If  WPRBSN  is  greater  than  zero,  a  PRBASIN 
record  must  follow  the  PRWINDOW  record  or  PRNODE  record  if  the  SELECT  option 
was  chosen  for  WPRNOD.  Variable  NELBSN  on  record  PRBASIN  is  the  number  of 
elements  in  a  particular  output  basin.  An  array  of  the  specific  element 
numbers  in  the  basin,  BSNELE,  is  then  read  from  PRBNELEM  records  following  the 
PRBASIN  record.  The  number  of  PRBASIN  records  must  equal  the  value  specified 
in  WPRBSN. 
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PART  V:  ILLUSTRATIVE  EXAMPLES 


72.  Two  examples  are  included  in  this  section  to  demonstrate  HARBD's 
capabilities.  The  model  was  used  to  simulate  the  harbor  wave  response  of  Agat 
Harbor,  Guam  and  Maalaea  Harbor,  Maui,  Hawaii. 

Agat  Harbor .  Guam 

73.  Agat  Harbor  is  located  on  the  west  coast  of  the  island  of  Guam 
which  is  part  of  the  Marianas  Islands  in  the  South  Pacific  Ocean.  The  design 
plan  of  the  harbor  (Figure  9-6)  consists  of  a  930-ft-long,  120-ft-wide,  and 


Figure  9-6.  Design  plan  of  Agat  Harbor,  Guam 


14-ft-deep  entrance  channel;  a  150-ft-wide,  120-ft-long,  and  14-ft-deep 
turning  basin;  a  600-ft-long,  75-ft-wide,  and  9-ft-deep  access  channel;  and  a 
600-ft-long,  300-ft-wide,  and  9-ft-deep  berthing  area.  Protective  structures 
include  revetments  along  the  shore;  a  180- ft- long  stub  breakwater  and 
revetment  at  the  south  end  of  the  harbor;  and  an  885-ft-long  detached 
breakwater  seaward  of  the  harbor  basin. 

74.  The  HARBD  finite  element  grid  generated  for  the  harbor  is  shown  in 
Figure  9-7.  At  the  time  of  this  study,  a  grid  resolution  of  four  elements  per 
wavelength  was  sufficien*"  It  was  later  determined  that  accuracy  increased 
with  a  resolution  no  larger  than  six  elements  per  wavelength.  The  bathymetry 
was  obtained  from  hydrographic  surveys  prepared  by  the  US  Army  Engineer 
Division,  Pacific  Ocean  (POD).  The  grid  consists  of  1,334  nodes,  2,421 
elements,  84  elements  along  the  semicircular  boundary,  164  boundary  elements 
in  the  near  region,  and  a  matrix  bandwidth  of  88.  Boundary  reflection 
coefficients  were  0.2  for  the  shoreline  outside  the  harbor  (beaches),  0.45  for 
the  revetment  inside  the  harbor  and  outside  the  detached  breakwater,  and  0.5 
for  the  stub  breakwater,  the  north  face  of  the  shoreline  revetment,  and  inside 
the  detached  breakwater.  A  bottom  friction  coefficient  of  0.0  was  used  for 
all  elements . 


Figure  9-7.  HARBD  finite  element  grid  of  Agat  Harbor,  Guam 
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75.  Two  wave  conditions  were  tested,  an  8 -sec  wave  and  an  11 -sec  wave 
from  a  248.1-deg  azmith  (329.7-deg  model  coordinates).  As  recommended,  a 
value  of  0.0  was  used  for  the  incident  wave  amplitude.  Thirty- two  output 
basins  were  selected  for  output  and  are  listed  in  the  output  summary  in 
Table  9-4  (shown  in  Figure  9-8).  The  input  data  set  is  given  in  Appendix  9-C 
for  details  of  each  record.  The  complete  output  listing  is  given  in 
Appendix  9-D. 


Figure  9-8.  Output  basin  locations  for  Agat  Harbor,  Guam 

76.  The  goal  of  the  study  was  to  develop  a  design  plan  that  would 
provide  the  harbor  with  adequate  protection  from  the  incident  wave  climate. 

The  US  Army  Corps  of  Engineers  criteria  for  adequate  harbor  protection  is  that 
wave  heights  must  be  less  than  1  ft  in  harbor  berthing  areas  and  less  than 
2  ft  in  the  entrance  channel  and  turning  basin  for  a  period  less  than 
10  percent  of  the  time  per  year.  The  design  plan  tested  failed  to  meet  the 
criterion  for  adequate  harbor  protection.  Wave  heights  exceeded  the  criteria 
in  output  basins  19  and  22,  which  are  located  near  the  shore  in  the  northeast 
corner  of  the  harbor.  Modifications  to  the  design  plan  were  tested  to 
determine  an  optimal  design  to  adequately  protect  the  harbor. 
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Table  9-3 

Output  Summary  for  Agat  Harbor.  Guam  Simulation 


COASTAl  MOOCtiaC  STSfCa  (Cas):  • 

-  MARO  '  HAASO  MAMiAl  CKAMPtC  MK»IEM 

•  ••••  gEHSPECS  CARO:  SPCCinCAIlQM  Of  IITLC  ARO  GENERAL  STSfCM  OE  UNITS 

VARIA8LC  OCSCtlPIlON  Of  USAGE:  VALUE:  NOTES:  *  VARIAtLE  OfSCRIPTlON  Of  USAGE: 


VERSION  1.0 


VALUE:  NOTES: 


SUNITS 

UNITS  STSTEN  USED  IN  OONPUTATIONS 

METRIC  • 

•••«.  CRiOSPEC  CARO:  SPCC1EICA1 iOM  OE  THE  EINtTE-CLCNENT  GRID  * 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE:  NOTES:  * 

CRTTPE 

TYPE  OF  EIHITE-CLEMENT  GRID 

TRtAMC  • 

NNOO 

IRMER  OE  GRID  NODES 

86  * 

NODR 

IRMKR  OE  NODES  OR  SEMICIRCULAR  NOUN  19  * 

HtAND 

tAMUlOTN  OF  GRID 

2T 

PRUIHDOU  CARD:  SPEClElCAriOH  Of  THE  MODEL  OUtPUf 

VARIAtLE 

DESCRIPTION  OE  USAGE: 

VALUE:  NOTES:  * 

IMROD 

PVIHTING  Of  NODAL  SOU/TIONS 

SELECT  * 

HQOOUI 

NUMCR  Of  NODES  SCUaED  fOR  OUTPUT 

5  ^ 

NAXtSM 

SPCClflED  MXIM8I  URMR  Of  MSINS 

2  ^ 

yPROOF 

PRINTING  Of  QOEfflClCKT  SQLUTIORS 

ns  * 

8ASIH  • 

NUMOCR  Of  ELEICHIS 

4 

1 

1 

•••••  yAVCONO  CARO:  TIMER  Of  UAVE  OOWlllONS:  1 

UAVE 

COWITIOH  NU»«EI;  1 

VMIAOLC 

OESCRIPTIOH  OE  USAGE: 

VALUE:  NOTES:  ^ 

MEEP 

OCEPUATCt  UAVE  NEICNT 

O.OS 

IDCfP 

DCEPMTCt  UAVE  MIGLC 

270.00 

VA81ASLE  OESCRiPT ION  OE  USAGE:  VALUE:  NOTES: 

'TS  STSTEN  Of  UNITS  USED  fOR  TlK  SRIO  fCTRIC 

NELC  MMEI  Of  GRID  EUlCNTS  118 

NEL8  HUMER  Of  MAfiART  ELCKHlS  M 

RMiUS  RADIUS  Of  KMICIICLE  2.00 


VMlAiU  KSOlirTlOH  Of  USAfiE: 
tiUQRB  VCCIfta  MX  HMKR  Of  OUTfVI  NODES 

LMiRM  mtmm  or  vcctfis  rasins 
NARCU  MfCtfICD  MX  ilMNIt  IN  ANT  MSIN 
•  INRONP  PRINTINC  Of  flNIlf  ELBCN1  MID  TfS 


VALUE:  NOTES: 


UATff  KHIQD 


'  lOEEP 

COASTAL  MOOCiINO  STSTEN  <CNS): 

•«•••  tATttSPCC  CAXD:  SPCCIf  fCAIlOH  Of  OATimCTRT/TQNOORANNT  > 

VAAIA8LE  OCSaiPTIOM  OF  USAGE:  VALUE:  NOTES:  *  VARlAliC  OESCRIPTIOH  Of  USAGE: 

'  UDATTAT  OATIAI  fOR  UATER  OEPTRS 


VALUE:  WTES: 

«.2y 


VERSIOR  1.0 


Mils  STSTEN  OE  tXfITS  fOR  0EP1N  DATA 
fARO  UATER  DEPTH  Of  fAR  REGION 


MTCRS 

10.128 


NUNKR  Of  CLEVATIOM  CHANGES  ■ 


CONVERGENCE  CRITERIA  ARC  AS  fOLLOUS: 

VARIAtLE  DESCRIPTION  or  USAGE:  VALUE:  NOTES:  *  VARIAtLE  DESCRIPTION  OE  USA«E: 

RCEICC  REEL.  COEEE.  ALONG  OPEN  CWST  tNDRT  1.00000 


•••  INPUT  PROCESSING  COMPLETED: 

FATAL  ERRORS-  0  UARNiNGS-  0 
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Maalaea  Harbor.  Maui.  Hawaii 


77.  In  the  Hawaiian  Island  chain,  Maalaea  Harbor  is  located  on  the 
southwest  coast  of  the  island  of  Maui.  The  shoreline  of  Maalaea  Bay  is  part 
of  an  isthmus  connecting  two  inactive  volcanos  which  form  west  and  east  Maui 
(Figure  9-9).  Maalaea  Harbor  currently  experiences  adverse  conditions  that 
affect  navigation  and  mooring  of  vessels.  This  study  is  an  effort  to  develop 
a  design  plan  of  improvement  to  alleviate  the  current  problems  occurring  in 
the  harbor.  The  existing  harbor  configuration  and  one  alternate  design  plan 
are  presented.  Due  to  large  file  sizes,  only  the  input  and  output  listings  of 
the  existing  harbor  configuration  will  be  presented  in  this  chapter. 


MHo'autnc 

STATE  OF  HAWftll 


PACIFIC  OCEAN 


10 

IN  MILES 


Figure  9-9.  Project  location,  Maalaea  Harbor,  Maui,  Hawaii 


78.  The  existing  harbor  configuration  (Figure  9-10)  consists  of  a 
90-ft-wide,  12-ft-deep  entrance  channel;  a  1,000-ft-long,  90-ft-wide 
breakwater  on  the  south  side  of  the  basin;  an  870-ft-long  breakwater  on  the 
east  side  of  the  basin;  and  a  300-ft-long,  50-ft-wide  paved  wharf  on  the  north 
side  of  the  basin.  The  dredged  basin  area  is  11.3  acres. 


Figure  9-10.  Existing  configuration  of  Maalaea  Harbor,  Maui,  Hawaii 

79.  The  HARBD  finite  element  grid  generated  for  the  existing 
configuration  is  shown  in  Figure  9-11.  The  grid  was  designed  with  a  grid 
resolution  of  six  elements  per  wavelength  based  on  an  8-sec  wave  and  a  basin 
depth  of  8  ft.  The  bathymetry  was  obtained  from  hydrographic  surveys  prepared 
by  the  POD.  The  grid  consists  of  7,146  elements,  3,752  nodes,  105  nodes  on 
the  semicircular  boundary,  252  boundary  elements  in  near  region  A  ,  and  a 
matrix  bandwidth  of  107 .  The  radius  of  the  semicircular  ocean  boundary  3A 
is  approximately  800  ft.  Boundary  reflection  coefficients  were  0.4  for  the 
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seaward  and  harbor  sides  of  the  south  breakwater  and  along  the  west  and  north 
walls  of  the  basin,  1.0  for  the  paved  wharf,  and  0.35  for  the  seaward  and 
harbor  sides  of  the  east  breakwater.  A  bottom  friction  coefficient  of  0.05 
was  used  for  all  elements . 


Figure  9-11.  HARBD  finite  element  grid  of  the  existing 
configuration  of  Maalaea  Harbor,  Maui,  Hawaii 

80.  The  results  from  a  20-sec  wave  arriving  from  175  deg  (265-deg  model 
coordinates)  are  presented.  As  recommended,  a  value  of  0.0  was  used  for  the 
incident  wave  amplitude.  Sixteen  output  basins  were  selected  throughout  the 
harbor.  The  locations  of  the  output  basins  are  shown  in  Figure  9-12  and  are 
listed  in  the  output  sununary  in  Table  9-4.  The  input  data  set  is  given  in 
Appendix  9-E  for  details  of  each  record.  The  complete  output  listing  is  given 
in  Appendix  9-F. 

81.  The  goal  of  the  study  was  to  develop  a  design  plan  that  would 
provide  the  harbor  with  adequate  protection  from  the  incident  wave  climate. 

The  USAE  criteria  for  adequate  harbor  protection  are  that  wave  heights  must  be 
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Figure  9-12.  Output  basin  locations  for  existing  configuration 

less  than  1  ft  in  harbor  berthing  areas  and  less  than  2  ft  in  the  entrance 
channel  and  turning  basin  for  a  period  of  less  than  10  percent  of  the  year. 

As  expected,  the  existing  configuration  failed  to  meet  the  criteria  for 
adequate  harbor  protection.  Wave  heights  exceeded  the  criteria  in  all  output 
basins  except  those  located  along  the  west  wall  and  in  the  turning  basin. 

82.  Alternate  design  plans  were  developed  and  tested.  Alternate  Design 
Plan  I  (Figure  9-13)  Includes  the  following  modifications:  (a)  a  620-ft-long 
extension  to  the  existing  south  breakwater,  (b)  an  additional  400-ft-long 
revetment  on  the  seaward  side  of  the  existing  south  breakwater,  (c)  a  610-ft- 
long  entrance  channel,  varying  in  width  from  105  to  180  ft,  and  varying  in 
depth  from  12  to  15  ft;  and  (d)  a  1.7-acre,  12-ft-deep  turning  basin.  About 
80  ft  of  the  existing  east  breakwater  head  would  be  removed,  and  a  50-ft-wide, 
720-ft-long  interior  revetment  will  be  added  to  the  interior  of  the  east 
breakwater.  An  8-ft-deep  berthing  area  adjacent  to  the  east  breakwater  and  a 
center  revetment  for  a  fuel  station  are  included. 


9-35 


wave-length.  The  grid  consists  of  6,764  elements  and  3,613  nodes  (105  nodes 
on  the  semicircular  boundary,  356  boundary  elements  in  near  region  A  ),  and 
the  matrix  bandwidth  is  107.  The  radius  of  the  semicircular  ocean  boundary, 
dk  ,  is  approximately  800  ft.  Boundary  reflection  coefficients  of  the 
existing  structures  remained  unchanged.  However,  the  reflection  coefficients 
for  the  modifications  are  as  follows:  0.25  for  the  extension  and  additional 
revetment  to  the  existing  south  breakwater  and  0.35  for  the  center  and 
additional  revetment  to  the  east  breakwater.  A  bottom  friction  coefficient  of 
0.0  was  used  for  all  elements.  Twenty- three  output  basins  were  selected  and 
the  locations  are  shown  in  Figure  9-15.  Wave  heights  exceeded  the  1-ft 
criterion  in  output  basin  6,  just  inside  Che  entrance,  and  output  basin  11,  at 
the  wharf  along  the  north  wall.  However,  these  waves  did  not  occur  more  than 
10  percent  of  the  time  per  year. 


Figure  9-15.  Output  basin  locations  for  Alternate  Design  Plan  I 
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Table  9-4 

Output  Sionunarv  for  Maalaea  Harbor .  Maui ,  HI  Simulation 


COASTAL  MOOCIIMC  SYSTEM  <CMS)x  NAAtO  V  C  t  S  I  O  N  1.0 

-  MAS80  MAALAEA  NACSOR.  MAUI.  Ml  •  CttSTIMC  COWf ICUBAl ION  - 


CCNSPECS  CARO;  SPCCirtCATION  Of  TITLE  ANO  CEwERAi  SVStfM  O*  IMJIS 


VARIARLE  OESCRIRTtOW  OE  LTSACC : 


VALUE:  NOTES:  •  VARlARlC  MSCRIPT ION  Of  USACC  : 


SUNITS  UNITS  SYSTEM  USCO  IN  COMPUTATIONS  CNCLISN 


CRIOSPCC  CAM:  SPCCIPtCATlON  Of  TMC  ElHITC-CLEMCMf  OtiO  *  MAM.ACA.tHR 


VALUL  :  NOUS; 


VAIIIASIC  KSCaiRTlOU  Of  USAGE: 


VALUE:  MOTES:  «  VAAIAOLC  MSCRIRTIOH  Of  USAGE ; 


CRTTRE  TYRE  Of  f INtTC'CLCMCMT  CRIO  TRIAMC 


VALUE:  MOTES: 


*  GUUITS  SYSTEM  Of  UNITS  USED  fOR  THE  CRIO  EMClIStt 


MNOO  MUM8ER  Of  GRID  MOOES 


*  MEtE  MLMER  Of  CRIO  ElEMEMIS 


MOOR  WMCR  Of  MOOES  ON  SEMICIRCULAR  OOUN  105  •  MELt  HUNtER  Of  »aUMOART  CLEMENTS 


MtAM  tAMOUIOTM  Of  GRID 


'  RADIUS  RADIUS  Of  SCMICIKLC 


RRWIMOOU  CARO:  SRCCtflCAIKM  Of  T«C  MODEL  OUTRUf 


TMtlAALC  OCRCRIRTim  Of  USAGE; 


VALUE!  mtlSi  *  VARtADU  OESCRtRltOR  Of  USAS: 


VALUE:  MOTES: 


MRRMOO  MIRTIMG  Of  MODAL  SOU/TIOMS 


'  MAXHOD  SRECirtCO  MAX  MlMCt  Of  OUTfUl  MODES 


■ODOUT  MUfCR  Of  MOOES  SCLCCTCO  fOR  CUTfUT 


•  UNtSM  IRMCR  Of  SKClfICP  lASIMS 


MAXKH  SKClflGD  MAXIMUM  MUWCR  Of  •ASIMS 


^  Musu  SDCCirta  max  elbcmts  ih  amt  sasim 


URtcpf  MfffTiMS  or  oacrricicMT  solutioms  ho 


»  UTMB  MIMTIMG  Of  flMITE  EljBCMT  GRID  HO 


<t  or  ELEMEMTS 


••«««  uavCONO  CARO:  NUMRCI  Of  IMVE  CONDITIONS: 


WAVE  CONDITION  NUMRER:  1 


VARlAiLC  OCSOlirTlOM  Of  USACC; 


VALUE:  MOTES:  •  VARIADIC  OCSCRIRTION  Of  USAO: 


flOCjER  eCCRULTCR  UAVC  KfCNT 


TOCER  UAVE  KRIOP 


VALUE:  NOTES: 


ZDCCR  OCCrUATCR  HAVE  ANaC  265.00  • 

COASTAL  MOOCLIMG  STSICM  <CMS):  MARIO  V  C  I  S  I  0  M  1.0 


’•••  lATNSRCC  CARO:  SRCCff ICATIOM  Of  lATNYMCTtT/TOPOCRAPNT 


VARIAILC  OCSCRIPTIOH  Of  USAGE: 


VALUE:  MOTES:  *  VARIAM.C  DCSCRIRTIOM  Of  USAGE: 


VALUE:  MOTES: 


UNITS  STSTCM  Of  UNITS  fOR  OCRTN  DATA 
fARD  UATER  OCRTN  Of  EAR  REGION 


>  10ATUH  DATUM  fOR  WATER  OCRTNS 


MUMKR  Of  ELEVATION  CHANCES  «  0 


’  OOHIGCCCMCC  CRITERIA  ARE  AS  fOLLOWS: 


VARIAILC  DCSCRIRTIOM  Of  USACC: 


VALUE:  MOTES:  «  VARIAMC  OCSCRIRIION  Of  USAGE : 


tCflEC  tCH.  COEff.  ALONG  OPEN  COAST  IMDRT  O.TOOOO 


VALUE:  MOTES: 


IMUf  RROCCSSIMG  OONRLCTa: 
ratal  CRURSh  0  UMMIIMCS*  0 
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HARBD 


HARBD  FUNCTION  INDEX 


Model  Control  Specifications 

(Req)  GENSPECS  Specify  general  title  and  system  of  units 


Grid  Description 


(Req)  GRIDSPEC 

(Opt)  GRIDFORM 


Physical  Characteristics 


(Req) 

BATHS PEC 

(Opt) 

CHNGBATH 

(Req) 

WAVCOND 

(Opt) 

CONVERG 

Output  Specifications 

(Opt)  PRWINDOW 

(Opt)  PRNODE 

(Opt)  PRNODNUM 

(Opt)  PRBASIN 

(Opt)  PRBNELEM 


Specify  general  grid  characteristics 
Specify  grid  formats 


Specify  characteristics  of  bathymetry 

Specify  changes  to  the  bathymetric  data 

Specify  deepwater  wave  conditions 

Specify  reflection  coefficient  of  infinite 
coastlines 


Specify  printing  of  input  and  output  window 
Specify  nodes  and  printing  of  nodal  output 
Selected  node  numbers  to  print 
Specify  basins  and  printing  of  basin  output 
Element  numbers  in  a  basin 
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CMS  Data  Specification:  GENSPECS  Record:  (Req) 

Purpose:  Specify  general  title  and  system  of  units. 
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CMS  Data  Specification;  GRIDSPEC  Record;  (Req) 

Purpose;  Specify  general  computational  grid  characteristics. 
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CMS  Data  Specification:  BATHSPEC  Record:  (Req) 

Purpose:  Specify  general  characteristics  of  the  bathymetry/ topography  data. 
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CMS  Data  Specification:  CHNGBATH  Record:  (Opt) 

Purpose:  Specify  changes  to  the  bathymetry  data. 
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CMS  Data  Specification:  CONVERG  Record:  (Opt) 

Purpose:  Specify  changes  to  convergence  criteria 
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CMS  Data  Specification:  PRWINDOW  Record:  (Opt) 

Purpose:  Specify  print  windows. 
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CMS  Data  Specification:  PRNODE  Record:  (Opt) 

Purpose:  Specify  number  of  nodes  for  output. 
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CMS  Data  Specification:  PRNODNUM  Record:  (C-Opt) 

Purpose:  Specify  nodes  for  output. 
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CMS  Data  Specification;  PRBASIN  Record:  (Opt) 

Purpose:  Specify  number  of  elements  in  output  basin. 
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CMS  Data  Specification;  PRBNELEM  Record:  (C-Opt) 

Purpose:  Specify  elements  in  output  basin. 
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APPENDIX  9-B:  INPUT  DATA  SET 
FOR  FINITE  ELEMENT  GRID 


9-57 


GENSPECS 

METRIC 

HARD  - 

HARBD 

MANUAL  EXAMPLE  PROBLEM 

GRIDSPEC 
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57  1.00 

1.09 

34 

90 

1.00 
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GENSPECS 

ENGLISH 

HARD 

AGAT  HARBOR  WES 

PLAN 

GRIDSPEC 

TRIANG 

ENGLISH 

1334 

2421 

84 

164 

88 

AGAT . DAT 

CONVERG 

0.0 

WAVCOND 

0.00 

8.0 

329.7 

WAVCOND 

0.00 

11.0 

329.7 

PRWINDOW 

NO 

SELECT 

YES 

32 

PRNODE 

10 

PRNODNUM 

1 

100 

200 

300 

400 

500 

600 

700 

800 

PRNODNUM 

900 

PRBASIN 

6 

PRBNELEM 

1752 

1753 

1754 

1756 

1607 

1606 

PRBASIN 

13 

PRBNELEM 

1191 

1336 

1337 

1466 

1467 

1340 

1339 

1338 

1193 

PRBNELEM 

1192 

1196 

1195 

1194 

PRBASIN 

13 

PRBNELEM 

1187 

1186 

1046 

1045 

909 

1049 

1048 

1047 

911 

PRBNELEM 

910 

912 

913 

914 

PRBASIN 

13 

PRBNELEM 

907 

906 

905 

904 

775 

780 

779 

778 

777 

PRBNELEM 

776 

657 

656 

655 

PRBASIN 

6 

PRBNELEM 

769 

768 

767 

770 

646 

645 

PRBASIN 

6 

PRBNELEM 

761 

762 

763 

641 

640 

639 

PRBASIN 

6 

PRBNELEM 

757 

882 

881 

756 

755 

754 

PRBASIN 

6 

PRBNELEM 

877 

1009 

1008 

876 

875 

874 

PRBASIN 

6 

PRBNELEM 

1001 

1002 

1003 

1004 

1140 

1139 

PRBASIN 

6 

PRBNELEM 

1135 

1276 

1275 

1274 

1133 

1134 

PRBASIN 

13 

PRBNELEM 

860 

861 

862 

737 

736 

735 

738 

618 

617 

PRBNELEM 

616 

615 

614 

734 

PRBASIN 

13 

PRBNELEM 

622 

623 

528 

529 

530 

441 

440 

527 

526 

PRBNELEM 

525 

437 

438 

439 

PRBASIN 

13 

PRBNELEM 

446 

447 

448 

449 

450 

384 

383 

382 

381 

PRBNELEM 

445 

380 

315 

316 

PRBASIN 

13 

PRBNELEM 

389 

390 

391 

459 

460 

394 

393 

392 

323 

PRBNELEM 

322 

324 

325 

326 

PRBASIN 

13 

PRBNELEM 

464 

555 

556 

557 

558 

469 

468 

467 

466 

PRBNELEM 

465 

400 

401 

402 

PRBASIN 

13 

PRBNELEM 

269 

270 

271 

336 

337 

338 

273 

272 

214 

PRBNELEM 

213 

215 

216 

274 

PRBASIN 

13 

PRBNELEM 

204 

205 

206 

207 

208 

209 

158 

157 

156 

PRBNELEM 

155 

111 

112 

159 

PRBASIN 

13 
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PRBNELEM 

250 

251 

252 

253 

200 

199 

198 

197 

196 

PRBNELEM 

195 

147 

148 

149 

PRBASIN 

13 

PRBNELEM 

303 

304 

305 

306 

307 

245 

244 

243 

242 

PRBNELEM 

302 

241 

188 

189 

PRBASIN 

13 

PRBNELEM 

430 

517 

516 

611 

610 

609 

514 

515 

428 

PRBNELEM 

429 

427 

426 

513 

PRBASIN 

13 

PRBNELEM 

422 

423 

359 

360 

295 

294 

293 

358 

357 

PRBNELEM 

421 

356 

291 

292 

PRBASIN 

13 

PRBNELEM 

184 

185 

138 

139 

96 

95 

94 

137 

136 

PRBNELEM 

183 

135 

92 

93 

PRBASIN 

13 

PRBNELEM 

100 

101 

63 

64 

65 

34 

33 

62 

61 

PRBNELEM 

60 

30 

31 

32 

PRBASIN 

13 

PRBNELEM 

39 

72 

73 

74 

75 

43 

42 

41 

40 

PRBNELEM 

38 

15 

16 

17 

PRBASIN 

6 

PRBNELEM 

120 

121 

122 

123 

167 

168 

PRBASIN 

6 

PRBNELEM 

408 

409 

410 

474 

475 

476 

PRBASIN 

6 

PRBNELEM 

280 

281 

282 

283 

226 

225 

PRBASIN 

5 

PRBNELEM 

2056 

2057 

2058 

1900 

1899 

PRBASIN 

13 

PRBNELEM 

1615 

1616 

1617 

1766 

1767  1768 

1619  1618 

1473 

PRBNELEM 

1472 

1474 

1475 

1620 

PRBASIN 

6 

PRBNELEM 

668 

669 

670 

790 

791 

792 

PRBASIN 

6 

PRBNELEM 

1060 

1061 

1062 

1063 

927 

926 

PRBASIN 

6 

PRBNELEM 

1256 

1257 

1258 

1117 

1116  1115 

GRIDFORM 

(3(I6,2F10.2))(2(4I6.F8 

.2,F8.4)) 

(5(215, F5. 2)) 

1 

4.40 

50.80 

2 

-3.80 

48.80 

3 

-12.00 

46.70 

4 

28.80 

57.20 

5 

20.50 

55.10 

6 

12.10 

52.80 

7 

6.00 

59.00 

8 

-2.00 

56.70 

9 

-10.40 

54.40 

10 

-18.40 

52.50 

11 

-20.30 

44.40 

12 

36.90 

59.70 

13 

30.50 

65.50 

14 

22.20 

63.10 

15 

14.00 

61.00 

16 

7.60 

67.10 

17 

-0.50 

65.40 

18 

-8.70 

62.90 

19 

-16.80 

60.90 

20 

-24.90 

58.70 

21 

-26.90 

50.30 

22 

-28.50 

42.20 

23 

-37.00 

40.10 

24 

-44.80 

37.90 

25 

45.30 

61.50 

26 

38.70 

67.50 

27 

32.20 

73.60 

28 

23.80 

71.70 

29 

15.80 

69.30 

30 

9.50 

75.20 

31 

1.10 

73.10 

32 

-6.80 

71.00 

33 

-13.20 

77.40 

34 

-15.20 

68.70 

35 

-23.20 

66.80 

36 

-31.50 

64.70 

37 

-33.30 

56.60 

38 

-35.20 

48.30 

39 

-43.10 

46.10 

40 

-52.10 

43.80 

41 

-54.50 

35.70 

42 

-64.00 

38.40 

43 

53.10 

63.70 

44 

47.00 

69.80 

45 

40.20 

76.00 

46 

34.20 

81.50 

47 

25.70 

79.30 

48 

17.90 

77.50 
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49 

11 

00 

83 

90 

50 

2.80 

81 

40 

51 

-5. 

10 

79. 

50 

52 

-11 

50 

85 

70 

53 

-19.40 

83 

50 

54 

-21 

70 

75 

20 

55 

-29 

80 

73 

30 

56 

-37.80 

71 

40 

57 

-39. 

40 

62. 

40 

58 

-41 

30 

54 

40 

59 

-50.20 

52 

30 

60 

-58. 

90 

49 

80 

61 

-60 

90 

46 

00 

62 

-69.50 

49 

10 

63 

-73 

50 

41 

70 

64 

61 

60 

65 

90 

65 

55.00 

72 

10 

66 

48 

70 

77 

90 

67 

42 

20 

84 

00 

68 

35.70 

90 

10 

69 

27 

60 

87. 

90 

70 

19 

20 

85 

70 

71 

12.90 

92 

00 

72 

4 

60 

89 

90 

73 

-3 

20 

87 

50 

74 

-9.70 

93 

50 

75 

-18 

00 

91 

40 

76 

-26 

20 

89 

40 

77 

-28.30 

81 

10 

78 

-36. 

00 

79 

30 

79 

-44 

90 

76 

90 

80 

-46.80 

68 

50 

81 

-48 

50 

60 

60 

82 

-57 

30 

57 

90 

83 

-66.10 

55 

80 

84 

-71 

20 

54 

30 

85 

-78 

40 

52 

20 

86 

-82.50 

44 

60 

87 

69 

90 

68 

30 

88 

63 

40 

73 

90 

89 

56.60 

80 

00 

90 

50. 

70 

86 

00 

91 

43 

70 

92 

20 

92 

37.40 

98 

00 

93 

29 

30 

96 

00 

94 

21 

10 

93 

90 

95 

14.80 

100 

00 

96 

6 

60 

97 

80 

97 

-1 

60 

95 

50 

98 

-7.90 

101 

70 

99 

-16 

20 

99 

40 

100 

-24 

70 

97 

70 

101 

-32.80 

95 

20 

102 

-34. 

40 

87 

40 

103 

-43 

30 

85 

00 

104 

-52.20 

82 

70 

105 

-53 

90 

74 

40 

106 

-55 

70 

66 

30 

107 

-64.60 

64 

00 

108 

-73 

10 

61 

50 

109 

-80 

60 

58 

00 

110 

-87.70 

55 

00 

111 

-91 

80 

48 

20 

112 

77 

50 

70 

40 

113 

71.40 

75 

70 

114 

64 

80 

82 

20 

115 

58 

60 

88 

30 

116 

52.10 

94 

00 

117 

45 

90 

100 

30 

118 

39 

50 

105 

80 

119 

30.90 

104 

20 

120 

22 

80 

102 

10 

121 

16 

60 

108 

40 

122 

8.40 

105 

80 

123 

0 

10 

103 

90 

124 

-6 

10 

109 

50 

125 

-14.20 

107 

60 

126 

-23 

10 

105 

50 

127 

-31 

10 

103 

20 

128 

-39.60 

101 

00 

129 

-42 

10 

92 

80 

130 

-50 

10 

91 

00 

131 

-58.90 

88 

90 

132 

-60 

70 

80 

20 

133 

-62 

70 

72 

00 

134 

-71.60 

69 

60 

135 

-80 

10 

67 

50 

136 

-82 

70 

63 

50 

137 

-89.60 

65 

20 

138 

-94 

30 

57 

00 

139 

-99 

30 

58 

60 

140 

-101.00 

51 

10 

141 

85 

80 

72 

30 

142 

79 

60 

78 

20 

143 

73.20 

84 

20 

144 

66 

90 

90 

40 

145 

60 

50 

96 

40 

146 

53.80 

102 

60 

147 

47 

50 

108 

50 

148 

40 

70 

114 

60 

149 

32.70 

112 

40 

150 

24 

60 

110 

40 

151 

18 

30 

116 

00 

152 

9.90 

114 

50 

153 

1 

80 

112 

00 

154 

-4 

50 

118 

00 

155 

-12.60 

115 

90 

156 

-20 

60 

113 

60 

157 

-27 

40 

119 

50 

158 

-29.20 

111 

20 

159 

-37 

90 

109 

50 

160 

-46 

80 

107 

00 

161 

-48.60 

98 

50 

162 

-57 

20 

96 

30 

163 

-66 

40 

94 

30 

164 

-68.10 

86 

20 

165 

-69 

90 

78 

00 

166 

-78 

70 

75 

50 

167 

-87.10 

73 

40 

168 

-95 

70 

75 

.10 

169 

-97 

50 

67 

10 

170 

-102.90 

63 

80 

171 

-108 

30 

61 

.10 

172 

-110 

10 

54 

50 

173 

94.30 

74 

40 

174 

88 

40 

80 

.60 

175 

81 

40 

86 

50 

176 

75.30 

92 

60 

177 

68 

80 

98 

.50 

178 

62 

20 

104 

60 

179 

55.90 

110 

50 

180 

49 

.40 

116 

.60 

181 

42 

80 

122 

60 

182 

34.60 

120 

50 

183 

26 

30 

118 

.20 

184 

20 

20 

124 

60 

185 

11.70 

122 

30 

186 

3 

50 

120 

.20 

187 

-2 

80 

126 

50 

188 

-11.10 

123 

90 

189 

-19 

.30 

121 

.90 

190 

-25 

60 

128 

20 

191 

-34.50 

125 

.80 

192 

-36 

.40 

117 

.30 

193 

-45 

00 

115 

30 

194 

-53.80 

112 

70 

195 

-55 

90 

104 

.70 

196 

-64 

60 

102 

40 

197 

-73.20 

100 

.00 

198 

-75 

.00 

91 

.70 

199 

-76 

80 

83 

90 

200 

-85.70 

81 

.30 

201 

-94 

.20 

80 

.60 

202 

-103 

90 

76 

70 

203 

-106.10 

69 

.20 

204 

-113 

.60 

70 

.90 

205 

-115 

80 

63 

90 

206 

-118,40 

57 

20 

207 

102 

.40 

76 

.80 

208 

96 

30 

82 

80 

209 

89.80 

88 

.80 

210 

83 

.40 

94 

.60 
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211 

76.90 

100.60 

212 

70.50 

106.90 

213 

64.00 

112.90 

214 

57.50 

118.70 

215 

51.50 

124.90 

216 

44.50 

130.90 

217 

36.40 

128.70 

218 

28.40 

126.80 

219 

21.80 

132.60 

220 

13.40 

130.50 

221 

5.10 

128.40 

222 

-1.00 

134.40 

223 

-9.10 

132.30 

224 

-17.40 

130 . 30 

225 

-23.90 

136 . 30 

226 

-32.80 

133.80 

227 

-41.50 

131.30 

228 

-43.50 

123.40 

229 

-52.30 

121.10 

230 

-60.90 

118.70 

231 

-63.00 

110.50 

232 

-71.60 

lu8.40 

233 

-80.70 

106.00 

234 

-82.40 

97.90 

235 

-83.90 

89.70 

236 

-92.70 

87.30 

237 

-101.60 

85.20 

238 

-111.00 

78.30 

239 

-119.10 

71.50 

240 

-122.20 

63.00 

241 

-130.50 

58.60 

242 

-125.00 

54.30 

243 

-127.50 

46.20 

244 

-130.40 

38.10 

245 

-133.30 

29.50 

246 

-136.60 

20.80 

247 

-138.80 

14.40 

248 

-133.50 

8.20 

249 

-141.10 

8.20 

250 

110.70 

81.40 

251 

106 . 30 

86.60 

252 

100.70 

92.00 

253 

94.00 

98.30 

254 

87.50 

104.50 

255 

80.40 

110.70 

256 

73.90 

116.50 

257 

67.20 

122.00 

258 

60.50 

127.70 

259 

53.70 

133.80 

260 

47.00 

139.40 

261 

38.40 

137.00 

262 

29.70 

134.50 

263 

23.70 

140.70 

264 

15.30 

138.80 

265 

6.70 

136.30 

266 

0.70 

142.40 

267 

-7.50 

140.20 

268 

-15.30 

138.40 

269 

-22.10 

144 . 70 

270 

-31.20 

142 . 30 

271 

-40.20 

139.80 

272 

-48.60 

137.60 

273 

-50.70 

129.30 

274 

-59.40 

126.90 

275 

-68.10 

124.60 

276 

-69.90 

116.50 

277 

-78.80 

114.30 

278 

-87.70 

111.90 

279 

-89.20 

103.50 

280 

-90.80 

95.90 

281 

-99.80 

93.40 

282 

-105.30 

94.80 

283 

-107.90 

86.50 

284 

-113.40 

88.20 

285 

-116.50 

79.90 

286 

-124.70 

75.00 

287 

-127.50 

66.90 

288 

-136.30 

63.50 

289 

-139.60 

55.40 

290 

-133.60 

51.10 

291 

-136.70 

42.90 

292 

-139.60 

34.70 

293 

-142.70 

26.00 

294 

-145.10 

19.70 

295 

-147.00 

12.60 

296 

-148.60 

7.70 

297 

119.50 

80.90 

298 

115.20 

88.70 

299 

110.20 

95.90 

300 

104.40 

101.10 

301 

97.20 

107.30 

302 

90.50 

113.40 

303 

83.20 

119.70 

304 

76.60 

125.30 

305 

69.70 

131.00 

306 

63.10 

136.80 

307 

55.90 

142 . 20 

308 

49.20 

147,60 

309 

40.20 

145.20 

310 

31.30 

142.70 

311 

25.50 

148.90 

312 

17.00 

146.80 

313 

8.40 

144.60 

314 

2.20 

150.80 

315 

-6.00 

148.70 

316 

-14.10 

146.90 

317 

-20.20 

152.60 

318 

-29.10 

150.10 

319 

-37.80 

148 . 10 

320 

-47.00 

145.50 

321 

-55.80 

143.70 

322 

-57.30 

135.50 

323 

-66.20 

132.90 

324 

-75.20 

130.70 

325 

-76.70 

122.70 

326 

-85.60 

120.00 

327 

-94.90 

117.80 

328 

-96.50 

109.90 

329 

-98.20 

101.60 

330 

-104.00 

98.10 

331 

-109.10 

100.50 

332 

-110.50 

96.60 

333 

-116.10 

97.10 

334 

-118.70 

90.50 

335 

-121.30 

83.30 

336 

-129.90 

79.00 

337 

-133.10 

71.20 

338 

-142.30 

68.10 

339 

-145.10 

60.10 

340 

-148.20 

52.50 

341 

-142.30 

47.70 

342 

-145.20 

39.50 

343 

-148.60 

31.10 

344 

-151.30 

24.40 

345 

-153.40 

16.90 

346 

-156.30 

7.10 

347 

148.40 

1.90 

348 

146.10 

10.40 

349 

143.80 

19.10 

350 

141.60 

27.40 

351 

139.30 

35.60 

352 

137.30 

44.10 

353 

134.70 

52.40 

354 

132.70 

60.90 

355 

130.60 

69.10 

356 

125.80 

76.90 

357 

130.40 

84.20 

358 

125.40 

90.60 

359 

119.50 

98.70 

360 

114.10 

104.90 

361 

108.40 

110.70 

362 

101.00 

116.50 

363 

94.10 

122.40 

364 

86.70 

128.80 

365 

79.70 

134.20 

366 

72.50 

139.90 

367 

65.40 

145.30 

368 

58.70 

151.00 

369 

51.80 

156.30 

370 

42.70 

153.80 

371 

34.20 

151.00 

372 

27.50 

157.30 
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697 

156.60 

123 

.50 

698 

700 

139.40 

145 

.80 

701 

703 

119.70 

161 

.70 

704 

706 

94.20 

178 

.60 

707 

709 

71.40 

193 

.50 

710 

712 

45.30 

193 

.40 

713 

715 

20.80 

194 

.70 

716 

718 

-3.20 

196 

.00 

719 

721 

-27.50 

197 

.20 

722 

724 

-54.00 

190 

.40 

725 

727 

-80.90 

183 

.20 

728 

730 

-100.20 

170 

.70 

731 

733 

-119.60 

158 

.10 

734 

736 

-138.90 

144 

.80 

737 

739 

-158.60 

132 

.00 

740 

742 

-170.10 

110 

.50 

743 

745 

-181.20 

88 

.70 

746 

748 

-192.70 

67 

.30 

749 

751 

-199.50 

43 

.70 

752 

754 

-197.60 

23 

.50 

755 

757 

-203.70 

3 

.80 

758 

760 

203.40 

18 

.80 

761 

763 

196.80 

45 

.30 

764 

766 

190.40 

71 

.70 

767 

769 

184.80 

95 

90 

770 

772 

171.70 

118 

40 

773 

775 

154.90 

140 

00 

776 

778 

138.00 

162 

30 

779 

781 

114.90 

175 

70 

782 

784 

89.40 

192 

10 

785 

787 

66.50 

206 

80 

788 

790 

41.60 

207 
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665 

332 

331 

392 

17.20 

0.0000 

666 

333 

332 

392 

18.20 

0 . 0000 

667 

333 

392 

393 

20.20 

0.0000 

668 

333 

393 

394 

18.20 

0 . 0000 

669 

334 

333 

394 

14.20 

0 . 0000 

670 

334 

394 

395 

12.20 

0 . 0000 

671 

335 

334 

395 

8.20 

0 . 0000 

672 

336 

335 

395 

7.70 

0.0000 

673 

336 

395 

396 

7.70 

0 . 0000 

674 

336 

396 

397 

7.70 

0 . 0000 

675 

337 

336 

397 

7.70 

0.0000 

676 

338 

337 

397 

7.70 

0.0000 

677 

338 

397 

398 

7.70 

0.0000 

678 

338 

398 

399 

7.70 

0.0000 

679 

339 

338 

399 

7.70 

0.0000 

680 

339 

399 

400 

7.70 

0 . 0000 

681 

340 

339 

400 

7.70 

0 . 0000 

682 

340 

400 

401 

7.70 

0 . 0000 

683 

340 

401 

402 

7.70 

0 . 0000 

684 

341 

340 

402 

7.70 

0 . 0000 

685 

342 

341 

402 

7.70 

0.0000 

686 

342 

402 

403 

7.70 

0 . 0000 

687 

343 

342 

403 

7.70 

0.0000 

688 

343 

403 

404 

7.70 

0 . 0000 

689 

344 

343 

404 

7.70 

0 . 0000 

690 

344 

404 

405 

7.70 

0 . 0000 

691 

345 

344 

405 

7.20 

0 . 0000 

692 

345 

405 

406 

6.20 

0.0000 

693 

346 

345 

406 

5.20 

0 . 0000 

694 

407 

346 

406 

3.20 

0.0000 

695 

347 

408 

409 

2.20 

0 . 0000 

696 

348 

347 

409 

2.20 

0 . 0000 

697 

348 

409 

410 

3.20 

0 . 0000 

698 

349 

348 

410 

4.20 

0 . 0000 

699 

349 

410 

411 

5.20 

0.0000 

700 

350 

349 

411 

5.20 

0 . 0000 

701 

350 

411 

412 

6.20 

0.0000 

702 

351 

350 

412 

6.20 

0 . 0000 

703 

351 

412 

413 

7.20 

0 . 0000 

704 

352 

351 

413 

7.20 

0 . 0000 

705 

352 

413 

414 

7.70 

0 . 0000 

706 

353 

352 

414 

7.70 

0 . 0000 

707 

353 

414 

415 

7.70 

0.0000 

708 

354 

353 

415 

7.70 

0 . 0000 

709 

354 

415 

416 

7.70 

0.0000 

710 

355 

354 

416 

7.70 

0.0000 

711 

355 

416 

417 

7.70 

0.0000 

712 

356 

355 

417 

7.70 

0 . 0000 

713 

357 

356 

417 

7.70 

0 . 0000 

714 

357 

417 

418 

7.70 

0 . 0000 

715 

357 

418 

419 

7.70 

0.0000 

716 

358 

357 

419 

7.70 

0 . 0000 

717 

358 

419 

420 

7.70 

0.0000 

718 

359 

358 

420 

7.70 

0 . 0000 

719 

359 

420 

421 

7.70 

0.0000 

720 

360 

359 

421 

7.70 

0 . 0000 

721 

360 

421 

422 

7.70 

0.0000 

722 

361 

360 

422 

7.70 

0 . 0000 

723 

361 

422 

423 

7.70 

0.0000 

724 

362 

361 

423 

7.70 

0 . 0000 

725 

362 

423 

424 

7.70 

0.0000 

726 

363 

362 

424 

11.20 

0 . 0000 

727 

363 

424 

425 

11.20 

0.0000 

728 

364 

363 

425 

14.20 

0.0000 

729 

364 

425 

426 

14.20 

0.0000 

730 

365 

364 

426 

14.20 

0.0000 

731 

365 

426 

427 

14.20 

0 . 0000 

732 

366 

365 

427 

14.20 

0 . 0000 

733 

366 

427 

428 

14.20 

0 . 0000 

734 

367 

366 

428 

14.20 

0 . 0000 

735 

367 

428 

429 

14.20 

0.0000 

736 

368 

367 

429 

14.20 

0 . 0000 

737 

368 

429 

430 

14.20 

0.0000 

738 

369 

368 

430 

14.20 

0 . 0000 

739 

369 

430 

431 

14.20 

0.0000 

740 

369 

431 

432 

14.20 

0.0000 

741 

370 

369 

432 

14.20 

0 . 0000 

742 

370 

432 

433 

14.20 

0.0000 

743 

371 

370 

433 

14.20 

0 . 0000 

744 

372 

371 

433 

14.20 

0 . 0000 

745 

372 

433 

434 

14.20 

0.0000 

746 

372 

434 

435 

15.20 

0 . 0000 

747 

373 

372 

435 

14.20 

0 . 0000 

748 

373 

435 

436 

15.20 

0 . 0000 

749 

374 

373 

436 

14.20 

0.0000 

750 

375 

374 

436 

15.20 

0 . 0000 

751 

375 

436 

437 

16.20 

0 . 0000 

752 

375 

437 

438 

16.20 

0 . 0000 

753 

376 

375 

438 

16.20 

0 . 0000 

754 

376 

438 

439 

16.20 

0 . 0000 

755 

377 

376 

439 

16.20 

0 . 0000 

756 

378 

377 

439 

16.20 

0 . 0000 

757 

3/8 

439 

440 

16.20 

0.0000 

758 

378 

440 

441 

16.20 

0.0000 

759 

379 

378 

441 

16.20 

0.0000 

760 

379 

441 

442 

16.20 

0.0000 

761 

380 

379 

442 

16.20 

0 . 0000 

762 

380 

442 

443 

16.20 

0 . 0000 
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763 

381 

380 

443 

16.20 

0.0000 

764 

381 

443 

444 

16.20 

0.0000 

765 

382 

381 

444 

16.20 

0 . 0000 

766 

382 

444 

445 

16.20 

0.0000 

767 

383 

382 

445 

16.20 

0.0000 

768 

383 

445 

446 

16.20 

0.0000 

769 

383 

446 

447 

16.20 

0.0000 

770 

384 

383 

447 

16.20 

0.0000 

771 

385 

384 

447 

18.20 

0 . 0000 

772 

385 

447 

448 

18.20 

0.0000 

773 

386 

385 

448 

18.20 

C . 0000 

774 

386 

448 

449 

18.20 

0.0000 

775 

386 

449 

450 

18.20 

0.0000 

776 

387 

386 

450 

18.20 

0.0000 

777 

388 

387 

450 

18.20 

0.0000 

778 

388 

450 

451 

18.20 

0.0000 

779 

389 

388 

451 

18.20 

0.0000 

780 

389 

451 

452 

18.20 

0.0000 

781 

389 

452 

453 

18.20 

0.0000 

782 

390 

389 

453 

18.20 

0.0000 

783 

390 

453 

454 

19.20 

0.0000 

784 

391 

390 

454 

19.20 

0,0000 

785 

392 

391 

454 

20.20 

0 . 0000 

786 

392 

454 

455 

20.20 

0.0000 

787 

393 

392 

455 

21.20 

0 . 0000 

788 

393 

455 

456 

21.20 

0.0000 

789 

393 

456 

457 

21.20 

0.0000 

790 

394 

393 

457 

21.20 

0.0000 

791 

394 

457 

458 

19.20 

0 . 0000 

792 

395 

394 

458 

14.20 

0.0000 

793 

396 

395 

458 

11.20 

0 . 0000 

794 

396 

458 

459 

11.20 

0.0000 

795 

396 

459 

460 

11.20 

0 . 0000 

796 

397 

396 

460 

7.70 

0.0000 

797 

398 

397 

460 

7.70 

0 . 0000 

798 

398 

460 

461 

7.70 

0.0000 

799 

398 

461 

462 

7.70 

0 . 0000 

800 

399 

398 

462 

7.70 

0.0000 

801 

399 

462 

463 

7.70 

0 . 0000 

802 

400 

399 

463 

7.70 

0.0000 

803 

400 

463 

464 

7.70 

0.0000 

804 

401 

400 

464 

7.70 

0.0000 

805 

401 

464 

466 

7.70 

0 . 0000 

806 

466 

464 

465 

7.70 

0.0000 

807 

401 

466 

467 

7.70 

0 . 0000 

808 

402 

401 

467 

7.70 

0.0000 

809 

403 

402 

467 

7.70 

0.0000 

810 

403 

467 

468 

7.70 

0.0000 

811 

404 

403 

468 

7.70 

0.0000 

812 

404 

468 

469 

7.70 

0.0000 

813 

405 

404 

469 

7.70 

0.0000 

814 

405 

469 

470 

7.70 

0.0000 

815 

406 

405 

470 

6.20 

0.0000 

816 

406 

470 

471 

6.20 

0.0000 

817 

407 

406 

471 

4.20 

0.0000 

818 

472 

407 

471 

3.20 

0.0000 

819 

408 

473 

474 

2.20 

0.0000 

820 

409 

408 

474 

2.20 

0.0000 

821 

409 

474 

475 

3.20 

0.0000 

822 

410 

409 

475 

4.20 

0.0000 

823 

410 

475 

476 

5.20 

0.0000 

824 

411 

410 

476 

5.20 

0.0000 

825 

411 

476 

477 

6.20 

0.0000 

826 

412 

411 

477 

6.20 

0.0000 

827 

412 

477 

478 

7.20 

0.0000 

828 

413 

412 

478 

7.70 

0.0000 

829 

413 

478 

479 

7.70 

0.0000 

830 

414 

413 

479 

7.70 

0.0000 

831 

414 

479 

480 

7.70 

0.0000 

832 

415 

414 

480 

7.70 

0.0000 

833 

415 

480 

481 

7.70 

0.0000 

834 

416 

415 

481 

7.70 

0.0000 

835 

416 

481 

482 

7.70 

0.0000 

836 

417 

416 

482 

7.70 

0.0000 

837 

418 

417 

482 

7.70 

0.0000 

838 

418 

482 

483 

7.70 

0.0000 

839 

419 

418 

483 

7.70 

0.0000 

840 

419 

483 

484 

7.70 

0.0000 

841 

419 

484 

485 

7.70 

0.0000 

842 

420 

419 

485 

7.70 

0.0000 

843 

420 

485 

486 

7.70 

0.0000 

844 

421 

420 

486 

7.70 

0.0000 

845 

421 

486 

487 

7.70 

0.0000 

846 

422 

421 

487 

7.70 

0.0000 

847 

422 

487 

488 

7.70 

0.0000 

848 

423 

422 

488 

7.70 

0.0000 

849 

423 

488 

489 

7.70 

0.0000 

850 

424 

423 

489 

7.70 

0.0000 

851 

424 

489 

490 

7.70 

0.0000 

852 

425 

424 

490 

7.70 

0.0000 

853 

425 

490 

491 

7.70 

0.0000 

854 

426 

425 

491 

11.20 

0.0000 

855 

426 

491 

492 

11.20 

0.0000 

856 

427 

426 

492 

14.20 

0.0000 

857 

427 

492 

493 

14.20 

0.0000 

858 

428 

427 

493 

14.20 

0.0000 

859 

428 

493 

494 

14.20 

0 . 0000 

860 

429 

428 

494 

14.20 

0.0000 

861 

429 

494 

495 

14.20 

0.0000 

862 

430 

429 

495 

14.20 

0.0000 

863 

430 

495 

496 

14.20 

0.0000 

864 

431 

430 

496 

14.20 

0.0000 

865 

431 

496 

497 

15.20 

0.0000 

866 

431 

497 

498 

15.20 

0.0000 

867 

432 

431 

498 

15.20 

0.0000 

868 

432 

498 

499 

15.20 

0.0000 

869 

433 

432 

499 

16.20 

0 . 0000 

870 

434 

433 

499 

16.20 

0.0000 
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871 

434 

499 

500 

16.20 

0.0000 

873 

435 

434 

501 

16.20 

0 . 0000 

875 

436 

435 

502 

16.20 

0 . 0000 

877 

437 

502 

503 

16.20 

0 . 0000 

879 

438 

437 

504 

16.20 

0 . 0000 

881 

439 

438 

505 

16.20 

0.0000 

883 

440 

505 

506 

16.20 

0.0000 

885 

441 

440 

507 

16.20 

0 . 0000 

887 

442 

441 

508 

16.20 

0.0000 

889 

443 

442 

509 

16.20 

0.0000 

891 

444 

443 

510 

16.20 

0.0000 

893 

445 

444 

511 

16.20 

0 . 0000 

895 

446 

445 

512 

16.20 

0 . 0000 

897 

446 

513 

514 

18.20 

0.0000 

899 

448 

447 

514 

18.20 

0 . 0000 

901 

449 

448 

515 

18.20 

0 . 0000 

903 

449 

516 

517 

18.20 

0 . 0000 

905 

451 

450 

517 

18.20 

0.0000 

907 

452 

451 

518 

18.20 

0.0000 

909 

452 

519 

520 

18.20 

0.0000 

911 

453 

520 

521 

19.20 

0.0000 

913 

455 

454 

521 

20.20 

0.0000 

915 

456 

455 

522 

21.20 

0.0000 

917 

456 

523 

524 

21.20 

0 . 0000 

919 

457 

524 

525 

21.20 

0 . 0000 

921 

459 

458 

525 

17.20 

0.0000 

923 

459 

526 

527 

17.20 

0.0000 

925 

461 

460 

527 

8.20 

0.0000 

927 

461 

528 

529 

8.20 

0.0000 

929 

462 

529 

530 

7.70 

0.0000 

931 

463 

530 

531 

7.70 

0 . 0000 

933 

465 

464 

531 

7.70 

0 . 0000 

935 

465 

532 

533 

7.70 

0 . 0000 

937 

466 

465 

534 

7.70 

0.0000 

939 

467 

466 

535 

7.70 

0 . 0000 

941 

468 

535 

536 

7.70 

0.0000 

943 

469 

536 

537 

7.70 

0.0000 

945 

470 

537 

538 

7.20 

0.0000 

947 

471 

538 

539 

5.20 

0 . 0000 

949 

540 

472 

539 

2.20 

0 . 0000 

951 

474 

473 

542 

2.20 

0 . 0000 

953 

475 

474 

543 

4.20 

0.0000 

955 

476 

475 

544 

6.20 

0.0000 

957 

477 

476 

545 

6.20 

0 . 0000 

959 

478 

477 

546 

7.70 

0 . 0000 

961 

479 

478 

547 

7.70 

0 . 0000 

963 

480 

479 

548 

7.70 

0.0000 

965 

481 

480 

549 

7.70 

0.0000 

967 

482 

481 

550 

7.70 

0 . 0000 

969 

483 

550 

551 

7.70 

0 . 0000 

971 

484 

551 

552 

7.70 

0.0000 

973 

485 

484 

553 

7.70 

0 . 0000 

975 

486 

485 

554 

7.70 

0.0000 

977 

487 

486 

555 

7.70 

0.0000 

872 

434 

500 

501 

16.20 

0 . 0000 

874 

435 

501 

502 

16.20 

0.0000 

876 

437 

436 

502 

16.20 

0 . 0000 

878 

437 

503 

504 

16.20 

0.0000 

880 

438 

504 

505 

16.20 

0.0000 

882 

440 

439 

505 

16.20 

0 . 0000 

884 

440 

506 

507 

16.20 

0 . 0000 

886 

441 

507 

508 

16.20 

0.0000 

888 

442 

508 

509 

16.20 

0.0000 

890 

443 

509 

510 

16.20 

0.0000 

892 

444 

510 

511 

16.20 

0.0000 

894 

445 

511 

512 

16.20 

0 . 0000 

896 

446 

512 

513 

17.20 

0 . 0000 

898 

447 

446 

514 

18.20 

0 . 0000 

900 

448 

514 

515 

18.20 

0.0000 

902 

449 

515 

516 

18.20 

0 . 0000 

904 

450 

449 

517 

18.20 

0.0000 

906 

451 

517 

518 

18.20 

0 . 0000 

908 

452 

518 

519 

18.20 

0 . 0000 

910 

453 

452 

520 

18.20 

0 . 0000 

912 

454 

453 

521 

19.20 

0.0000 

914 

455 

521 

522 

21.20 

0 . 0000 

916 

456 

522 

523 

21.20 

0.0000 

918 

457 

456 

524 

21.20 

0 . 0000 

920 

458 

457 

525 

21.20 

0 . 0000 

922 

459 

525 

526 

17.20 

0 . 0000 

924 

460 

459 

527 

13.20 

0.0000 

926 

461 

527 

528 

8.20 

0.0000 

928 

462 

461 

529 

7.70 

0.0000 

930 

463 

462 

530 

7.70 

0 . 0000 

932 

464 

463 

531 

7.70 

0 . 0000 

934 

465 

531 

532 

7.70 

0.0000 

936 

465 

533 

534 

7.70 

0.0000 

938 

466 

534 

535 

7.70 

0.0000 

940 

468 

467 

535 

7.70 

0.0000 

942 

469 

468 

536 

7.70 

0 . 0000 

944 

470 

469 

537 

7.70 

0.0000 

946 

471 

470 

538 

6.20 

0.0000 

948 

472 

471 

539 

3.20 

0 . 0000 

950 

473 

541 

542 

1.20 

0.0000 

952 

474 

542 

543 

4.20 

0 . 0000 

954 

475 

543 

544 

6.20 

0 . 0000 

956 

476 

544 

545 

6.20 

0 . 0000 

958 

477 

545 

546 

7.20 

0 . 0000 

960 

478 

546 

547 

7.70 

0 . 0000 

962 

479 

547 

548 

7.70 

0 . 0000 

964 

480 

548 

549 

7.70 

0 . 0000 

966 

481 

549 

550 

7.70 

0 . 0000 

968 

483 

482 

550 

7.70 

0 . 0000 

970 

484 

483 

551 

7.70 

0 . 0000 

972 

484 

552 

553 

7.70 

0.0000 

974 

485 

553 

554 

7.70 

0 . 0000 

976 

486 

554 

555 

7.70 

0.0000 

978 

487 

555 

556 

7.70 

0 . 0000 
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979 

488 

487 

556 

7.70 

0.0000 

980 

488 

556 

557 

7.70 

0.0000 

981 

489 

488 

557 

7.70 

0.0000 

982 

489 

557 

558 

7.70 

0.0000 

983 

490 

489 

558 

7.70 

0.0000 

984 

490 

558 

559 

7.70 

0.0000 

985 

491 

490 

559 

7.70 

0.0000 

986 

491 

559 

560 

7.70 

0.0000 

987 

492 

491 

560 

7.70 

0.0000 

988 

492 

560 

561 

7.70 

0.0000 

989 

493 

492 

561 

11.20 

0.0000 

990 

493 

561 

562 

11.20 

0.0000 

991 

494 

493 

562 

14.20 

0.0000 

992 

494 

562 

563 

14.20 

0.0000 

993 

495 

494 

563 

14.20 

0.0000 

994 

495 

563 

564 

14.20 

0.0000 

995 

496 

495 

564 

14.20 

0.0000 

996 

496 

564 

565 

15.20 

0.0000 

997 

497 

496 

565 

16.20 

0.0000 

998 

497 

565 

566 

16.20 

0.0000 

999 

497 

566 

567 

16.20 

0.0000 

1000 

498 

497 

567 

16.20 

0.0000 

1001 

498 

567 

568 

16.20 

0.0000 

1002 

499 

498 

568 

16.20 

0.0000 

1003 

500 

499 

568 

16.20 

0.0000 

1004 

500 

568 

569 

16.20 

0.0000 

1005 

500 

569 

570 

16.20 

0.0000 

1006 

501 

500 

570 

16.20 

0.0000 

1007 

501 

570 

571 

16.20 

0.0000 

1008 

502 

501 

571 

16.20 

0.0000 

1009 

503 

502 

571 

16.20 

0.0000 

1010 

503 

571 

572 

16.20 

0.0000 

1011 

503 

572 

573 

16.20 

0 . 0000 

1012 

504 

503 

573 

16.20 

0.0000 

1013 

504 

573 

574 

16.20 

0 . 0000 

1014 

505 

504 

574 

16.20 

0.0000 

1015 

506 

505 

574 

16.20 

0.0000 

1016 

506 

574 

575 

12.20 

0.0000 

1017 

506 

575 

576 

12.20 

0.0000 

1018 

507 

506 

576 

12.20 

0.0000 

1019 
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0.0000 

1646 

838 

837 

918 

4.20 

0.0000 

1648 

839 

838 

919 

5.20 

0.0000 

1650 

840 

839 

920 

6.20 

0.0000 

1652 

841 

840 

921 

7.70 

0.0000 

1654 

842 

841 

922 

7.70 

0.0000 

1656 

843 

842 

923 

7.70 

0.0000 

1658 

844 

843 

924 

7.70 

0 . 0000 

1660 

845 

844 

925 

7.70 

0.0000 

1662 

846 

845 

926 

7.70 

0.0000 

1664 

847 

926 

927 

7.70 

0.0000 

1666 

848 

927 

928 

7.70 

0.0000 

1668 

849 

848 

929 

7.70 

0.0000 

1670 

850 

849 

930 

7.70 

0.0000 

1672 

851 

850 

931 

7.70 

0.0000 

1674 

852 

851 

932 

7.70 

0.0000 

1676 

853 

852 

933 

7.70 

0.0000 

1678 

854 

853 

934 

7.70 

0.0000 

1680 

855 

854 

935 

7.70 

0.0000 

1682 

856 

855 

936 

7.70 

0.0000 

1684 

857 

856 

937 

7.70 

0.0000 

1686 

858 

857 

938 

7.70 

0.0000 

1688 

859 

858 

939 

7.70 

0.0000 

1690 

859 

940 

860 

7.70 

0.0000 

1692 

860 

941 

861 

7.70 

0.0000 

1694 

861 

942 

862 

7.70 

0.0000 

1696 

862 

943 

863 

7.70 

0.0000 

1698 

863 

944 

864 

7.70 

0.0000 

1700 

864 

945 

865 

7.70 

0.0000 

1702 

865 

946 

866 

7.70 

0.0000 

1704 

947 

948 

866 

7.70 

0.0000 

1706 

948 

949 

867 

7.70 

0.0000 

1708 

949 

869 

868 

7.70 

0.0000 

1710 

872 

953 

954 

7.70 

0.0000 

1712 

873 

954 

955 

7.70 

0.0000 

1714 

875 

874 

955 

7.70 

0.0000 

1716 

875 

956 

957 

7.70 

0.0000 

1718 

876 

957 

958 

7.70 

0.0000 

1720 

877 

958 

959 

7.70 

0.0000 

1722 

878 

959 

960 

7.70 

0 . 0000 

1724 

879 

960 

961 

7.70 

0.0000 

1726 

880 

961 

962 

7.70 

0.0000 

1728 

881 

962 

963 

7.70 

0.0000 

1730 

883 

882 

963 

7.70 

0.0000 

1732 

884 

883 

964 

7.70 

0.0000 

1734 

885 

884 

965 

7.70 

0.0000 
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1735 

885 

965 

966 

7.70 

0 . 0000 

1737 

886 

966 

967 

7.70 

0.0000 

1739 

887 

967 

968 

7.70 

0 . 0000 

1741 

888 

887 

969 

7.70 

0.0000 

1743 

889 

969 

970 

7.70 

0.0000 

1745 

890 

970 

971 

7.70 

0.0000 

1747 

893 

975 

894 

7.70 

0.0000 

1749 

895 

894 

976 

7.70 

0.0000 

1751 

896 

976 

977 

7.70 

0.0000 

1753 

897 

977 

978 

7.70 

0.0000 

1755 

980 

978 

979 

7.70 

0.0000 

1757 

898 

980 

981 

15.20 

0 . 0000 

1759 

900 

899 

981 

21.20 

0.0000 

1761 

900 

982 

983 

21.20 

0.0000 

1763 

902 

901 

983 

21.20 

0 . 0000 

1765 

902 

984 

985 

21.20 

0.0000 

1767 

903 

985 

986 

21.20 

0.0000 

1769 

904 

986 

987 

21.20 

0.0000 

1771 

906 

905 

987 

21.20 

0.0000 

1773 

906 

988 

989 

21.20 

0.0000 

1775 

907 

989 

990 

13.20 

0.0000 

1777 

908 

990 

991 

7.70 

0.0000 

1779 

909 

991 

992 

7.70 

0.0000 

1781 

910 

992 

993 

7.70 

0.0000 

1783 

911 

993 

994 

7.70 

0 . 0000 

1785 

913 

912 

994 

6.20 

0.0000 

1787 

914 

913 

995 

5.20 

0.0000 

1789 

915 

914 

996 

2.20 

0.0000 

1791 

916 

998 

999 

2.20 

0 . 0000 

1793 

917 

999 

1000 

4.20 

0 . 0000 

1795 

918 

1000 

1001 

5.20 

0 . 0000 

1797 

919 

1001 

1002 

6.20 

0.0000 

1799 

920 

1002 

1003 

7.20 

0.0000 

1801 

921 

1003 

1004 

7.70 

0 . 0000 

1803 

922 

1004 

1005 

7.70 

0.0000 

1805 

923 

1005 

1006 

7.70 

0 . 0000 

1807 

924 

1006 

1007 

7.70 

0.0000 

1809 

925 

1007 

1008 

7.70 

0 . 0000 

1811 

926 

1008 

1009 

7.70 

0.0000 

1813 

927 

1009 

1010 

7.70 

0 . 0000 

1815 

928 

ICIO 

1011 

7.70 

0.0000 

1817 

929 

1011 

1012 

7.70 

0.0000 

1819 

930 

1012 

1013 

7.70 

0 . 0000 

1821 

931 

1013 

1014 

7.70 

0 . 0000 

1823 

932 

1014 

1015 

7.70 

0 . 0000 

1825 

933 

1015 

1016 

7.70 

0.0000 

1827 

934 

1016 

1017 

7.70 

0 . 0000 

1829 

935 

934 

1018 

7.70 

0.0000 

1831 

936 

935 

1019 

7.70 

0.0000 

1833 

937 

936 

1020 

7.70 

0 . 0000 

1835 

938 

937 

1021 

7.70 

0.0000 

1837 

938 

1022 

1023 

7.70 

0.0000 

1839 

950 

1032 

1033 

7.70 

0 . 0000 

1841 

951 

950 

1034 

7.70 

0.0000 

1736 

886 

885 

966 

7.70 

0 . 0000 

1738 

887 

886 

967 

7.70 

0 . 0000 

1740 

887 

968 

969 

7.70 

0.0000 

1742 

889 

888 

969 

7.70 

0 . 0000 

1744 

890 

889 

970 

7.70 

0.0000 

1746 

972 

890 

971 

7.70 

0 . 0000 

1748 

894 

975 

976 

7.70 

0 . 0000 

1750 

896 

895 

976 

7.70 

0.0000 

1752 

897 

896 

977 

7.70 

0 . 0000 

1754 

897 

978 

980 

7.70 

0 . 0000 

1756 

898 

897 

980 

11.20 

0.0000 

1758 

899 

898 

981 

21.20 

0.0000 

1760 

900 

981 

982 

21.20 

0.0000 

1762 

901 

900 

983 

21.20 

0.0000 

1764 

902 

983 

984 

21.20 

0.0000 

1766 

903 

902 

985 

21.20 

0 . 0000 

1768 

904 

903 

986 

21.20 

0 . 0000 

1770 

905 

904 

987 

21.20 

0.0000 

1772 

906 

987 

988 

21.20 

0.0000 

1774 

907 

906 

989 

17.20 

0.0000 

1776 

908 

907 

990 

9.20 

0.0000 

1778 

909 

908 

991 

7.70 

0.0000 

1780 

910 

909 

992 

7.70 

0.0000 

1782 

911 

910 

993 

7.70 

0.0000 

1784 

912 

911 

994 

7.70 

0 . 0000 

1786 

913 

994 

995 

6.20 

0 . 0000 

1788 

914 

995 

996 

5.20 

0.0000 

1790 

997 

915 

996 

2.20 

0 . 0000 

1792 

917 

916 

999 

2.20 

0.0000 

1794 

918 

917 

1000 

4.20 

0.0000 

1796 

919 

918 

1001 

5.20 

0 . 0000 

1798 

920 

919 

1002 

6.20 

0 . 0000 

1800 

921 

920 

1003 

7.70 

0 . 0000 

1802 

922 

921 

1004 

7.70 

0 . 0000 

1804 

923 

922 

1005 

7.70 

0.0000 

1806 

924 

923 

1006 

7.70 

0.0000 

1808 

925 

924 

1007 

7.70 

0.0000 

1810 

926 

925 

1008 

7.70 

0.0000 

1812 

927 

926 

1009 

7.70 

0.0000 

1814 

928 

927 

1010 

7.70 

0 . 0000 

1816 

929 

928 

1011 

7.70 

0 . 0000 

1818 

930 

929 

1012 

7.70 

0.0000 

1820 

931 

930 

1013 

7.70 

0.0000 

1822 

932 

931 

1014 

7.70 

0 . 0000 

1824 

933 

932 

1015 

7.70 

0.0000 

1826 

934 

933 

1016 

7.70 

0.0000 

1828 

934 

1017 

1018 

7.70 

0 . 0000 

1830 

935 

1018 

1019 

7.70 

0.0000 

1832 

936 

1019 

1020 

7.70 

0 . 0000 

1834 

937 

1020 

1021 

7.70 

0.0000 

1836 

938 

1021 

1022 

7.70 

0.0000 

1838 

1023 

939 

938 

7.70 

0 . 0000 

1840 

950 

1033 

1034 

7.70 

0 . 0000 

1842 

951 

1034 

1035 

7.70 

0.0000 

9-88 


1843 

952 

951 

1035 

7.70 

0.0000 

1844 

953 

952 

1035 

7.70 

0.0000 

1845 

953 

1035 

1036 

7.70 

0.0000 

1846 

953 

1036 

1037 

7.70 

0.0000 

1847 

954 

953 

1037 

7.70 

0 . 0000 

1848 

954 

1037 

1038 

7.70 

0.0000 

1849 

955 

954 

1038 

7.70 

0.0000 

1850 

956 

955 

1038 

7.70 

0.0000 

1851 

956 

1038 

1039 

7.70 

0 . 0000 

1852 

956 

1039 

1040 

7.70 

0.0000 

1853 

957 

956 

1040 

7.70 

0.0000 

1854 

957 

1040 

1041 

7.70 

0.0000 

1855 

958 

957 

1041 

7.70 

0 . 0000 

1856 

958 

1041 

1042 

7.70 

0.0000 

1857 

959 

958 

1042 

7.70 

0.0000 

1858 

959 

1042 

1043 

7.70 

0.0000 

1859 

960 

959 

1043 

7.70 

0 . 0000 

1860 

960 

1043 

1044 

7.70 

0.0000 

1861 

961 

960 

1044 

7.70 

0.0000 

1862 

961 

1044 

1045 

7.70 

0.0000 

1863 

962 

961 

1045 

7.70 

0 . 0000 

1864 

962 

1045 

1046 

7.70 

0.0000 

1865 

963 

962 

1046 

7.70 

0 . 0000 

1866 

964 

963 

1046 

7.70 

0.0000 

1867 

964 

1046 

1047 

7.70 

0 . 0000 

1868 

965 

964 

1047 

7.70 

0.0000 

1869 

965 

1047 

1048 

7.70 

0.0000 

1870 

966 

965 

1048 

7.70 

0.0000 

1871 

966 

1048 

1049 

7.70 

0 . 0000 

1872 

967 

966 

1049 

7.70 

0.0000 

1873 

967 

1049 

1050 

7.70 

0.0000 

1874 

968 

967 

1050 

7.70 

0.0000 

1875 

968 

1050 

1051 

7.70 

0.0000 

1876 

968 

1051 

1052 

7.70 

0.0000 

1877 

969 

968 

1052 

7.70 

0.0000 

1878 

970 

969 

1052 

7.70 

0 . 0000 

1879 

970 

1052 

1053 

7.70 

0.0000 

1880 

971 

970 

1053 

7.70 

0.0000 

1881 

971 

1053 

1054 

7.70 

0.0000 

1882 

971 

1054 

1055 

7.70 

0.0000 

1883 

972 

971 

1055 

7.70 

0 . 0000 

1884 

972 

1055 

1056 

7.70 

0.0000 

1885 

973 

972 

1056 

7.70 

0 . 0000 

1886 

973 

1056 

1057 

7.70 

0.0000 

1887 

1058 

974 

1057 

7.70 

0 . 0000 

1888 

975 

1059 

976 

7.70 

0.0000 

1889 

976 

1059 

977 

7.70 

0 . 0000 

1890 

1059 

1060 

977 

7.70 

0 . 0000 

1891 

977 

1060 

978 

7.70 

0 . 0000 

1892 

1060 

1061 

978 

7.70 

0.0000 

1893 

979 

978 

1061 

7.70 

0 . 0000 

1894 

979 

1061 

1062 

7.70 

0.0000 

1895 

979 

1062 

1063 

7.70 

0.0000 

1896 

980 

979 

1063 

7.70 

0.0000 

1897 

981 

980 

1063 

13.20 

0.0000 

1898 

982 

981 

1063 

17.20 

0.0000 

1899 

982 

1063 

1064 

17.20 

0.0000 

1900 

982 

1064 

1065 

21.20 

0.0000 

1901 

983 

982 

1065 

21.20 

0.0000 

1902 

984 

983 

1065 

21.20 

0.0000 

1903 

984 

1065 

1066 

21.20 

0.0000 

1904 

984 

1066 

1067 

21.20 

0.0000 

1905 

985 

984 

1067 

21.20 

0.0000 

1906 

985 

1067 

1068 

21.20 

0 . 0000 

1907 

986 

985 

1068 

21.20 

0 . 0000 

1908 

986 

1068 

1069 

21.20 

0.0000 

1909 

987 

986 

1069 

21.20 

0 . 0000 

1910 

988 

987 

1069 

21.20 

0.0000 

1911 

988 

1069 

1070 

21.20 

0.0000 

1912 

988 

1070 

1071 

21.20 

0.0000 

1913 

989 

988 

1071 

21.20 

0 . 0000 

1914 

989 

1071 

1072 

17.20 

0.0000 

1915 

990 

989 

1072 

13.20 

0.0000 

1916 

990 

1072 

1073 

10.20 

0.0000 

1917 

991 

990 

1073 

7.70 

0 . 0000 

1918 

991 

1073 

1074 

7.70 

0.0000 

1919 

992 

991 

1074 

7.70 

0.0000 

1920 

992 

1074 

1075 

7.70 

0.0000 

1921 

993 

992 

1075 

7.70 

0 . 0000 

1922 

993 

1075 

1076 

7.70 

0 . 0000 

1923 

994 

993 

1076 

7.70 

0.0000 

1924 

995 

994 

1076 

6.20 

0.0000 

1925 

995 

1076 

1077 

6.20 

0 . 0000 

1926 

996 

995 

1077 

5.20 

0 . 0000 

1927 

996 

1077 

1078 

5.20 

0 . 0000 

1928 

997 

996 

1078 

2.20 

0.0000 

1929 

1079 

997 

1078 

2.20 

0 . 0000 

1930 

998 

1080 

1081 

2.20 

0.0000 

1931 

999 

998 

1081 

2.20 

0 . 0000 

1932 

999 

1081 

1082 

4.20 

0.0000 

1933 

1000 

999 

1082 

4.20 

0 . 0000 

1934 

1000 

1082 

1083 

5.20 

0.0000 

1935 

1001 

1000 

1083 

5.20 

0 . 0000 

1936 

1001 

1083 

1084 

6.20 

0 . 0000 

1937 

1002 

1001 

1084 

6.20 

0 . 0000 

1938 

1003 

1002 

1084 

7.20 

0 . 0000 

1939 

1003 

1084 

1085 

7.20 

0 . 0000 

1940 

1004 

1003 

1085 

7.70 

0.0000 

1941 

1004 

1085 

1086 

7.70 

0 . 0000 

1942 

1005 

1004 

1086 

7.70 

0 . 0000 

1943 

1005 

1086 

1087 

7.70 

0 . 0000 

1944 

1006 

1005 

1087 

7.70 

0 . 0000 

1945 

1006 

1087 

1088 

7.70 

0 . 0000 

1946 

1007 

1006 

1088 

7.70 

0.0000 

1947 

1007 

1088 

1089 

7.70 

0 . 0000 

1948 

1008 

1007 

1089 

7.70 

0.0000 

1949 

1008 

1089 

1090 

7.70 

0 . 0000 

1950 

1009 

1008 

1090 

7.70 

0.0000 
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1951 

1009 

1090 

1091 

7.70 

0 . 0000 

1952 

1010 

1009 

1091 

7.70 

0.0000 

1953 

1010 

1091 

1092 

7.70 

0.0000 

1954 

1011 

1010 

1092 

7.70 

0.0000 

1955 

1011 

1092 

1093 

7.70 

0 . 0000 

1956 

1012 

1011 

1093 

7.70 

0 . 0000 

1957 

1012 

1093 

1094 

7.70 

0 . 0000 

1958 

1013 

1012 

1094 

7.70 

0 . 0000 

1959 

1013 

1094 

1095 

7.70 

0.0000 

1960 

1014 

1013 

1095 

7.70 

0.0000 

1961 

1014 

1095 

1096 

7.70 

0.0000 

1962 

1015 

1014 

1096 

7.70 

0.0000 

1963 

1015 

1096 

1097 

7.70 

0 . 0000 

1964 

1016 

1015 

1097 

7.70 

0.0000 

1965 

7.016 

1097 

1098 

7.70 

0.0000 

1966 

1017 

1016 

1098 

7.70 

0 . 0000 

1967 

1017 

1098 

1099 

7.70 

0 . 0000 

1968 

1018 

1017 

1099 

7.70 

0 . 0000 

1969 

1018 

1099 

1100 

7.70 

0 . 0000 

1970 

1019 

1018 

1100 

7.70 

0 . 0000 

1971 

1019 

1100 

1101 

7.70 

0 . 0000 

1972 

1020 

1019 

1101 

7.70 

0 . 0000 

1973 

1020 

1101 

1102 

7.70 

0 . 0000 

1974 

1021 

1020 

1102 

7.70 

0 . 0000 

1975 

1021 

1102 

1103 

7.70 

0 . 0000 

1976 

1022 

1021 

1103 

7.70 

0.0000 

1977 

1022 

1103 

1104 

7.70 

0 . 0000 

1978 

1023 

1022 

1104 

7.70 

0 . 0000 

1979 

1023 

1104 

1105 

7.70 

0.0000 

1980 

1024 

1023 

1105 

7.70 

0.0000 

1981 

1024 

1105 

1106 

7.70 

0.0000 

1982 

1025 

1024 

1106 

7.70 

0 . 0000 

1983 

1025 

1106 

1107 

7.70 

0 . 0000 

1984 

1026 

1025 

1107 

7.70 

0 . 0000 

1985 

1026 

1107 

1108 

7.70 

0 . 0000 

1986 

1027 

1026 

1108 

7.70 

0 . 0000 

1987 

1027 

1108 

1109 

7.70 

0 . 0000 

1988 

1028 

1027 

1109 

7.70 

0.0000 

1989 

1028 

1109 

1110 

7.70 

0.0000 

1990 

1028 

1110 

1111 

7.70 

0 . 0000 

1991 

1029 

1028 

1111 

7.70 

0.0000 

1992 

1029 

1111 

1112 

7.70 

0.0000 

1993 

1030 

1029 

1112 

7.70 

0 . 0000 

1994 

1113 

1030 

1112 

7.70 

0.0000 

1995 

1031 

1114 

1115 

7.70 

0 . 0000 

1996 

1032 

1031 

1115 

7.70 

0.0000 

1997 

1032 

1115 

1116 

7.70 

0 . 0000 

1998 

1033 

1032 

1116 

7.70 

0 . 0000 

1999 

1033 

1116 

1117 

7.70 

0 . 0000 

2000 

1034 

1033 

1117 

7.70 

0 . 0000 

2001 

1034 

1117 

1118 

7.70 

0.0000 

2002 

1035 

1034 

1118 

7.70 

0 . 0000 

2003 

1035 

1118 

1119 

7.70 

0.0000 

2004 

1036 

1035 

1119 

7.70 

0.0000 

2005 

1036 

1119 

1120 

7.70 

0.0000 

2006 

1037 

1036 

1120 

7.70 

0.0000 

2007 

1037 

1120 

1121 

7.70 

0 . 0000 

2008 

1038 

1037 

1121 

7.70 

0 . 0000 

2009 

1038 

1121 

1122 

7.70 

0 . 0000 

2010 

1039 

1038 

1122 

7.70 

0 . 0000 

2011 

1039 

1122 

1123 

7.70 

0 . 0000 

2012 

1039 

1123 

1124 

7.70 

0 . 0000 

2013 

1040 

1039 

1124 

7.70 

0 . 0000 

2014 

1040 

1124 

1125 

7.70 

0 . 0000 

2015 

1041 

1040 

1125 

7.70 

0 . 0000 

2016 

1041 

1125 

1126 

7.70 

0 . 0000 

2017 

1042 

1041 

1126 

7.70 

0 . 0000 

2018 

1042 

1126 

1127 

7.70 

0 . 0000 

2019 

1043 

1042 

1127 

7.70 

0.0000 

2020 

1043 

1127 

1128 

7.70 

0.0000 

2021 

1044 

1043 

1128 

7.70 

0 . 0000 

2022 

1044 

1128 

1129 

7.70 

0 . 0000 

2023 

1045 

1044 

1129 

7.70 

0.0000 

2024 

1045 

1129 

1130 

7.70 

0.0000 

2025 

1046 

1045 

1130 

7.70 

0 . 0000 

2026 

1046 

1130 

1131 

7.70 

0.0000 

2027 

1047 

1046 

1131 

7.70 

0 . 0000 

2028 

1048 

1047 

1131 

7.70 

0.0000 

2029 

1048 

1131 

1132 

7.70 

0 . 0000 

2030 

1049 

1048 

1132 

7.70 

0 . 0000 

2031 

1049 

1132 

1133 

7.70 

0 . 0000 

2032 

1050 

1049 

1133 

7.70 

0.0000 

2033 

1050 

1133 

1134 

7.70 

0 . 0000 

2034 

1051 

1050 

1134 

7.70 

0 . 0000 

2035 

1051 

1134 

1135 

7.70 

0 . 0000 

2036 

1051 

1135 

1136 

7.70 

0 . 0000 

2037 

1052 

1051 

1136 

7.70 

0 . 0000 

2038 

1053 

1052 

1136 

7.70 

0.0000 

2039 

1053 

1136 

1137 

7.70 

0 . 0000 

2040 

1054 

1053 

1137 

7.70 

0 . 0000 

2041 

1054 

1137 

1138 

7.70 

0 . 0000 

2042 

1054 

1138 

1139 

7.70 

0 . 0000 

2043 

1055 

1054 

1139 

7.70 

0.0000 

2044 

1055 

1139 

1140 

7.70 

0 . 0000 

2045 

1056 

1055 

1140 

7.70 

0 . 0000 

2046 

1056 

1140 

1141 

7.70 

0 . 0000 

2047 

1057 

1056 

1141 

7.70 

0 . 0000 

2048 

1057 

1141 

1142 

7.70 

0.0000 

2049 

1058 

1057 

1142 

7.70 

0 . 0000 

2050 

1143 

1058 

1142 

7.70 

0.0000 

2051 

1061 

1146 

1062 

7.70 

0 . 0000 

2052 

1146 

1147 

1062 

7.70 

0.0000 

2053 

1062 

1147 

1148 

7.70 

0 . 0000 

2054 

1062 

1148 

1149 

7.70 

0 . 0000 

2055 

1063 

1062 

1149 

7.70 

0 . 0000 

2056 

1064 

1063 

1149 

9.20 

0 . 0000 

2057 

1064 

1149 

1150 

11.20 

0 . 0000 

2058 

1065 

1064 

1150 

17.20 

0.0000 
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2059 

1065 

1150 

1151 

19.20 

0 . 0000 

2060 

1066 

1065 

1151 

21.20 

2061 

1066 

1151 

1152 

21.20 

0.0000 

2062 

1067 

1066 

1152 

21.20 

2063 

1067 

1152 

1153 

21.20 

0.0000 

2064 

1068 

1067 

1153 

21.20 

2065 

1068 

1153 

1154 

21.20 

0 . 0000 

2066 

1068 

1154 

1155 

21.20 

2067 

1069 

1068 

1155 

21.20 

0 . 0000 

2068 

1070 

1069 

1155 

21.20 

2069 

1070 

1155 

1156 

21.20 

0 . 0000 

2070 

1070 

1156 

1157 

21.20 

2071 

1071 

1070 

1157 

21.20 

0 . 0000 

2072 

1071 

1157 

1158 

21.20 

2073 

1072 

1071 

1158 

17.20 

0.0000 

2074 

1072 

1158 

1159 

13.20 

2075 

1073 

1072 

1159 

9.20 

0 . 0000 

2076 

1073 

1159 

1160 

7.70 

2077 

1074 

1073 

1160 

7.70 

0 . 0000 

2078 

1074 

1160 

1161 

7.70 

2079 

1075 

1074 

1161 

7.70 

0 . 0000 

2080 

1075 

1161 

1162 

7.70 

2081 

1076 

1075 

1162 

7.70 

0 . 0000 

2082 

1076 

1162 

1163 

6.20 

2083 

1077 

1076 

1163 

6.20 

0 . 0000 

2084 

1077 

1163 

1164 

4.20 

2085 

1078 

1077 

1164 

4.20 

0 . 0000 

2086 

1078 

1164 

1165 

2.20 

2087 

1165 

1079 

1078 

2.20 

0.0000 

2088 

1080 

1166 

1167 

2.20 

2089 

1081 

1080 

1167 

2.20 

0 . 0000 

2090 

1081 

1167 

1168 

4.20 

2091 

1082 

1081 

1168 

4.20 

0 . 0000 

2092 

1082 

1168 

1169 

5.20 

2093 

1083 

1082 

1169 

5.20 

0 . 0000 

2094 

1083 

1169 

1170 

6.20 

2095 

1084 

1083 

1170 

6.20 

0.0000 

2096 

1084 

1170 

1171 

7.20 

2097 

1085 

1084 

1171 

7.70 

0 . 0000 

2098 

1085 

1171 

1172 

7.70 

2099 

1086 

1085 

1172 

7.70 

0.0000 

2100 

1086 

1172 

1173 

7.70 

2101 

1087 

1086 

1173 

7.70 

0.0000 

2102 

1087 

1173 

1174 

7.70 

2103 

1088 

1087 

1174 

7.70 

0.0000 

2104 

1088 

1174 

1175 

7.70 

2105 

1089 

1088 

1175 

7.70 

0.0000 

2106 

1089 

1175 

1176 

7.70 

2107 

1090 

1089 

1176 

7.70 

0.0000 

2108 

1090 

1176 

1177 

7.70 

2109 

1091 

1090 

1177 

7.70 

0.0000 

2110 

1091 

1177 

1178 

7.70 

2111 

1092 

1091 

1178 

7.70 

0.0000 

2112 

1092 

1178 

1179 

7.70 

2113 

1093 

1092 

1179 

7.70 

0.0000 

2114 

1093 

1179 

1180 

7.70 

2115 

1094 

1093 

1180 

7.70 

0.0000 

2116 

1094 

1180 

1181 

7.70 

2117 

1095 

1094 

1181 

7.70 

0.0000 

2118 

1095 

1181 

1182 

7.70 

2119 

1096 

1095 

1182 

7.70 

0.0000 

2120 

1096 

1182 

1183 

7.70 

2121 

1097 

1096 

1183 

7.70 

0 . 0000 

2122 

1097 

1183 

1184 

7.70 

2123 

1098 

1097 

1184 

7.70 

0.0000 

2124 

1098 

1184 

1185 

7.70 

2125 

1099 

1098 

1185 

7.70 

0.0000 

2126 

1099 

1185 

1186 

7.70 

2127 

1100 

1099 

1186 

7.70 

0 . 0000 

2128 

1100 

1186 

1187 

7.70 

2129 

1101 

1100 

1187 

7.70 

0.0000 

2130 

1101 

1187 

1188 

7.70 

2131 

1102 

1101 

1188 

7.70 

0 . 0000 

2132 

1102 

1188 

1189 

7.70 

2133 

1103 

1102 

1189 

7.70 

0.0000 

2134 

1103 

1189 

1190 

7.70 

2135 

1104 

1103 

1190 

7.70 

0 . 0000 

2136 

1104 

1190 

1191 

7.70 

2137 

1105 

1104 

1191 

7.70 

0.0000 

2138 

1105 

1191 

1192 

7.70 

2139 

1106 

1105 

1192 

7.70 

0 . 0000 

2140 

1106 

1192 

1193 

7.70 

2141 

1107 

1106 

1193 

7.70 

0 . 0000 

2142 

1107 

1193 

1194 

7.70 

2143 

1108 

1107 

1194 

7.70 

0.0000 

2144 

1108 

1194 

1195 

7.70 

2145 

1109 

1108 

1195 

7.70 

0.0000 

2146 

1110 

1109 

1195 

7.70 

2147 

1110 

1195 

1196 

7.70 

0 . 0000 

2148 

1110 

1196 

1197 

7.70 

2149 

1111 

1110 

1197 

7.70 

0 . 0000 

2150 

1111 

1197 

1198 

7.70 

2151 

1112 

1111 

1198 

7.70 

0 . 0000 

2152 

1112 

1198 

1199 

7.70 

2153 

1113 

1112 

1199 

7.70 

0 . 0000 

2154 

1113 

1199 

1200 

7.70 

2155 

1114 

1113 

1200 

7.70 

0 . 0000 

2156 

1114 

1200 

1201 

7.70 

2157 

1115 

1114 

1201 

7.70 

0 . 0000 

2158 

1115 

1201 

1202 

7.70 

2159 

1116 

1115 

1202 

7.70 

0 . 0000 

2160 

1116 

1202 

1203 

7.70 

2161 

1117 

1116 

1203 

7.70 

0.0000 

2162 

1117 

1203 

1204 

7.70 

2163 

1118 

1117 

1204 

7.70 

0 . 0000 

2164 

1118 

1204 

1205 

7.70 

2165 

1119 

1118 

1205 

7.70 

0 . 0000 

2166 

1119 

1205 

1206 

7.70 

0 . 0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0 . 0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0.0000 
0 . 0000 
0.0000 
0 . 0000 
0 . 0000 
0.0000 
0.0000 
0 . 0000 
0.0000 
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2167 

1120 

1119 

1206 

7.70 

0 . 0000 

2168 

1120 

1206 

1207 

7.70 

0 . 0000 

2169 

1121 

1120 

1207 

7.70 

0.0000 

2170 

1121 

1207 

1208 

7.70 

0 . 0000 

2171 

1122 

1121 

1208 

7.70 

0.0000 

2172 

1122 

1208 

1209 

7.70 

0.0000 

2173 

1123 

1122 

1209 

7.70 

0.0000 

2174 

1123 

1209 

1210 

7.70 

0.0000 

2175 

1124 

1123 

1210 

7.70 

0.0000 

2176 

1124 

1210 

1211 

7.70 

0.0000 

2177 

1125 

1124 

1211 

7.70 

0 . 0000 

2178 

1125 

1211 

1212 

7.70 

0.0000 

2179 

1126 

1125 

1212 

7.70 

0 . 0000 

2180 

1126 

1212 

1213 

7.70 

0 . 0000 

2181 

1127 

1126 

1213 

7.70 

0 . 0000 

2182 

1127 

1213 

1214 

7.70 

0.0000 

2183 

1128 

1127 

1214 

7.70 

0.0000 

2184 

1128 

1214 

1215 

7.70 

0.0000 

2185 

1129 

1128 

1215 

7.70 

0.0000 

2186 

1129 

1215 

1216 

7.70 

0.0000 

2187 

1130 

1129 

1216 

7.70 

0 . 0000 

2188 

1130 

1216 

1217 

7.70 

0.0000 

2189 

1131 

1130 

1217 

7.70 

0 . 0000 

2190 

1131 

1217 

1218 

7.70 

0.0000 

2191 

1132 

1131 

1218 

7.70 

0 . 0000 

2192 

1132 

1218 

1219 

7.70 

0 . 0000 

2193 

1133 

1132 

1219 

7.70 

0.0000 

2194 

1133 

1219 

1220 

7.70 

0 . 0000 

2195 

1134 

1133 

1220 

7.70 

0 . 0000 

2196 

1134 

1220 

1221 

7.70 

0 . 0000 

2197 

1135 

1134 

1221 

7.70 

0 . 0000 

2198 

1135 

1221 

1222 

7.70 

0 . 0000 

2199 

1136 

1135 

1222 

7.70 

0 . 0000 

2200 

1136 

1222 

1223 

7.70 

0.0000 

2201 

1137 

1136 

1223 

7.70 

0.0000 

2202 

1137 

1223 

1224 

7.70 

0.0000 

2203 

1138 

1137 

1224 

7.70 

0.0000 

2204 

1138 

1224 

1225 

7.70 

0.0000 

2205 

1139 

1138 

1225 

7.70 

0.0000 

2206 

1139 

1225 

1226 

7.70 

0.0000 

2207 

1140 

1139 

1226 

7.70 

0.0000 

2208 

1140 

1226 

1227 

7.70 

0 . 0000 

2209 

1141 

1140 

1227 

7.70 

0 . 0000 

2210 

1141 

1227 

1228 

7.70 

0.0000 

2211 

1142 

1141 

1228 

7.70 

0 . 0000 

2212 

1142 

1228 

1229 

7  70 

0 . 0000 

2213 

1143 

1142 

1229 

7.70 

0 . 0000 

2214 

1144 

1143 

1229 

7.70 

0 . 0000 

2215 

1144 

1229 

1230 

7.70 

0 . 0000 

2216 

1145 

1144 

1230 

7.70 

0 . 0000 

2217 

1145 

1230 

1231 

7.70 

0 . 0000 

2218 

1232 

1145 

1231 

7.70 

0 . 0000 

2219 

1147 

1233 

1234 

7.70 

0.0000 

2220 

1148 

1147 

1234 

7.70 

0 . 0000 

2221 

1148 

1234 

1235 

13.20 

0 . 0000 

2222 

1149 

1148 

1235 

11.20 

0.0000 

2223 

1150 

1149 

1235 

11.20 

0 . 0000 

2224 

1150 

1235 

1236 

17.20 

0.0000 

2225 

1151 

1150 

1236 

19.20 

0.0000 

2226 

1151 

1236 

1237 

21.20 

0.0000 

2227 

1152 

1151 

1237 

21.20 

0.0000 

2228 

1152 

1237 

1238 

21.20 

0 . 0000 

2229 

1153 

1152 

1238 

21.20 

0.0000 

2230 

1153 

1238 

1239 

21.20 

0 . 0000 

2231 

1154 

1153 

1239 

21.20 

0 . 0000 

2232 

1154 

1239 

1240 

21.20 

0 . 0000 

2233 

1155 

1154 

1240 

21.20 

0.0000 

2234 

1155 

1240 

1241 

21.20 

0.0000 

2235 

1156 

1155 

1241 

21.20 

0.0000 

2236 

1156 

1241 

1242 

21.20 

0.0000 

2237 

1157 

1156 

1242 

21.20 

0.0000 

2238 

1157 

1242 

1243 

21.20 

0 . 0000 

2239 

1158 

1157 

1243 

21.20 

0 . 0000 

2240 

1158 

1243 

1244 

17.20 

0 . 0000 

2241 

1159 

1158 

1244 

13.20 

0.0000 

2242 

1159 

1244 

1245 

11.20 

0.0000 

2243 

1160 

1159 

1245 

7.70 

0 . 0000 

2244 

1160 

1245 

1246 

7.70 

0 . 0000 

2245 

1161 

1160 

1246 

7.70 

0.0000 

2246 

1161 

1246 

1247 

7.70 

0.0000 

2247 

1162 

1161 

1247 

7.20 

0.0000 

2248 

1162 

1247 

1248 

6.20 

0 . 0000 

2249 

1163 

1162 

1248 

6.20 

0 . 0000 

2250 

1163 

1248 

1249 

4.20 

0.0000 

2251 

1164 

1163 

1249 

4.20 

0 . 0000 

2252 

1164 

1249 

1250 

2.20 

0 . 0000 

2253 

1250 

1165 

1164 

2.20 

0 . 0000 

2254 

1166 

1251 

1167 

2.20 

0 . 0000 

2255 

1251 

1252 

1167 

2.20 

0 . 0000 

2256 

1252 

1253 

1167 

4.20 

0.0000 

2257 

1168 

1167 

1253 

4.20 

0.0000 

2258 

1253 

1254 

1168 

5.20 

0 . 0000 

2259 

1169 

1168 

1254 

5.20 

0.0000 

2260 

1254 

1255 

1169 

6.20 

0 . 0000 

2261 

1170 

1169 

1255 

6.20 

0 . 0000 

2262 

1255 

1256 

1170 

7.70 

0 . 0000 

2263 

1171 

1170 

1256 

7.70 

0 . 0000 

2264 

1256 

1257 

1171 

7.70 

0 . 0000 

2265 

1172 

1171 

1257 

7.70 

0.0000 

2266 

1257 

1258 

1172 

7.70 

0 . 0000 

2267 

1173 

1172 

1258 

7.70 

0 . 0000 

2268 

1258 

1259 

1173 

7.70 

0.0000 

2269 

1174 

1173 

1259 

7.70 

0 . 0000 

2270 

1259 

1260 

1174 

7.70 

0.0000 

2271 

1175 

1174 

1260 

7.70 

0 . 0000 

2272 

1260 

1261 

1175 

7.70 

0 . 0000 

2273 

1176 

1175 

1261 

7.70 

0 . 0000 

2274 

1261 

1262 

1176 

7.70 

0 . 0000 
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2275 

1177 

1176 

1262 

7.70 

0.0000 

2277 

1178 

1177 

1263 

7.70 

0.0000 

2279 

1179 

1178 

1264 

7.70 

0.0000 

2281 

1180 

1179 

1265 

7.70 

0.0000 

2283 

1181 

1180 

1266 

7.70 

0.0000 

2285 

1182 

1181 

1267 

7.70 

0.0000 

2287 

1183 

1182 

1268 

7.70 

0.0000 

2289 

1184 

1183 

1269 

7.70 

0.0000 

2291 

1185 

1184 

1270 

7.70 

0.0000 

2293 

1186 

1185 

1271 

7.70 

0.0000 

2295 

1187 

1186 

1272 

7.70 

0 . 0000 

2297 

1188 

1187 

1273 

7.70 

0.0000 

2299 

1189 

1188 

1274 

7.70 

0.0000 

2301 

1190 

1189 

1275 

7.70 

0.0000 

2303 

1191 

1190 

1276 

7.70 

0.0000 

2305 

1192 

1191 

1277 

7.70 

0.0000 

2307 

1193 

1192 

1278 

7.70 

0.0000 

2309 

1194 

1193 

1279 

7.70 

0.0000 

2311 

1195 

1194 

1280 

7.70 

0.0000 

2313 

1196 

1195 

1281 

7.70 

0.0000 

2315 

1197 

1196 

1282 

7.70 

0.0000 

2317 

1198 

1197 

1283 

7.70 

0.0000 

2319 

1199 

1198 

1284 

7.70 

0.0000 

2321 

1200 

1199 

1285 

7.70 

0.0000 

2323 

1201 

1200 

1286 

7.70 

0.0000 

2325 

1202 

1201 

1287 

7.70 

0.0000 

2327 

1203 

1202 

1288 

7.70 

0.0000 

2329 

1204 

1203 

1289 

7.70 

0.0000 

2331 

1205 

1204 

1290 

7.70 

0 . 0000 

2333 

1206 

1205 

1291 

7.70 

0.0000 

2335 

1207 

1206 

1292 

7.70 

0.0000 

2337 

1208 

1207 

1293 

7.70 

0.0000 

2339 

1209 

1208 

1294 

7.70 

0.0000 

2341 

1210 

1209 

1295 

7.70 

0.0000 

2343 

1211 

1210 

1296 

7.70 

0.0000 

2345 

1212 

1211 

1297 

7.70 

0.0000 

2347 

1213 

1212 

1298 

7.70 

0.0000 

2349 

1214 

1213 

1299 

7.70 

0.0000 

2351 

1215 

1214 

1300 

7.70 

0.0000 

2353 

1216 

1215 

1301 

7.70 

0.0000 

2355 

1217 

1216 

1302 

7.70 

0 . 0000 

2357 

1218 

1217 

1303 

7.70 

0 . 0000 

2359 

1219 

1218 

1304 

7.70 

0.0000 

2361 

1220 

1219 

1305 

7.70 

0.0000 

2363 

1221 

1220 

1306 

7.70 

0 . 0000 

2365 

1222 

1221 

1307 

7.70 

0 . 0000 

2367 

1223 

1222 

1308 

7.70 

0 . 0000 

2369 

1224 

1223 

1309 

7.70 

0.0000 

2371 

1225 

1224 

1310 

7.70 

0.0000 

2373 

1226 

1225 

1311 

7.70 

0.0000 

2375 

1227 

1226 

1312 

7.70 

0.0000 

2377 

1228 

1227 

1313 

7.70 

0.0000 

2379 

1229 

1228 

1314 

7.70 

0.0000 

2381 

1230 

1229 

1315 

7.70 

0.0000 

2276 

1262 

1263 

1177 

7.70 

0.0000 

2278 

1263 

1264 

1178 

7.70 

0.0000 

2280 

1264 

1265 

1179 

7.70 

0.0000 

2282 

1265 

1266 

1180 

7.70 

0.0000 

2284 

1266 

1267 

1181 

7.70 

0.0000 

2286 

1267 

1268 

1182 

7.70 

0.0000 

2288 

1268 

1269 

1183 

7.70 

0.0000 

2290 

1269 

1270 

1184 

7.70 

0.0000 

2292 

1270 

1271 

1185 

7.70 

0.0000 

2294 

1271 

1272 

1186 

7.70 

0.0000 

2296 

1272 

1273 

1187 

7.70 

0.0000 

2298 

1273 

1274 

1188 

7.70 

0.0000 

2300 

1274 

1275 

1189 

7.70 

0.0000 

2302 

1275 

1276 

1190 

7.70 

0.0000 

2304 

1276 

1277 

1191 

7.70 

0.0000 

2306 

1277 

1278 

1192 

7.70 

0.0000 

2308 

1278 

1279 

1193 

7.70 

0.0000 

2310 

1279 

1280 

1194 

7.70 

0.0000 

2312 

1280 

1281 

1195 

7.70 

0.0000 

2314 

1281 

1282 

1196 

7.70 

0.0000 

2316 

1282 

1283 

1197 

7.70 

0 . 0000 

2318 

1283 

1284 

1198 

7.70 

0.0000 

2320 

1284 

1285 

1199 

7.70 

0.0000 

2322 

1285 

1286 

1200 

7.70 

0.0000 

2324 

1286 

1287 

1201 

7.70 

0.0000 

2326 

1287 

1288 

1202 

7.70 

0.0000 

2328 

1288 

1289 

1203 

7.70 

0.0000 

2330 

1289 

1290 

1204 

7.70 

0.0000 

2332 

1290 

1291 

1205 

7.70 

0.0000 

2334 

1291 

1292 

1206 

7.70 

0.0000 

2336 

1292 

1293 

1207 

7.70 

0.0000 

2338 

1293 

1294 

1208 

7.70 

0.0000 

2340 

1294 

1295 

1209 

7.70 

0.0000 

2342 

1295 

1296 

1210 

7.70 

0.0000 

2344 

1296 

1297 

1211 

7.70 

0.0000 

2346 

1297 

1298 

1212 

7.70 

0.0000 

2348 

1298 

1299 

1213 

7.70 

0.0000 

2350 

1299 

1300 

1214 

7.70 

0.0000 

2352 

1300 

1301 

1215 

7.70 

0.0000 

2354 

1301 

1302 

1216 

7.70 

0.0000 

2356 

1302 

1303 

1217 

7.70 

0.0000 

2358 

1303 

1304 

1218 

7.70 

0.0000 

2360 

1304 

1305 

1219 

7.70 

0.0000 

2362 

1305 

1306 

1220 

7.70 

0.0000 

2364 

1306 

1307 

1221 

7.70 

0.0000 

2366 

1307 

1308 

1222 

7.70 

0.0000 

2368 

1308 

1309 

1223 

7.70 

0.0000 

2370 

1309 

1310 

1224 

7.70 

0.0000 

2372 

1310 

1311 

1225 

7.70 

0 . 0000 

2374 

1311 

1312 

1226 

7.70 

0 . 0000 

2376 

1312 

1313 

1227 

7.70 

0.0000 

2378 

1313 

1314 

1228 

7.70 

0.0000 

2380 

1314 

1315 

1229 

7.70 

0 . 0000 

2382 

1231 

1230 

1315 

7.70 

0.0000 

9-^#3 


2383 

1315 

1316 

1231 

7.70 

0.0000 

2384 

1232 

1231 

1316 

7.70 

0 . 0000 

2385 

1316 

1317 

1232 

7.70 

0.0000 

2386 

1233 

1232 

1317 

7.70 

0 . 0000 

2387 

1317 

1318 

1233 

9.20 

0.0000 

2388 

1234 

1233 

1318 

11.20 

0.0000 

2389 

1318 

1319 

1234 

15.20 

0 . 0000 

2390 

1235 

1234 

1319 

15.20 

0 . 0000 

2391 

1319 

1320 

1235 

21.20 

0 . 0000 

2392 

1236 

1235 

1320 

21.20 

0 . 0000 

2393 

1320 

1321 

1236 

21.20 

0.0000 

2394 

1237 

1236 

1321 

21.20 

0.0000 

2395 

1321 

1322 

1237 

21.20 

0.0000 

2396 

1238 

1237 

1322 

21.20 

0 . 0000 

2397 

1322 

1323 

1238 

21.20 

0 . 0000 

2398 

1239 

1238 

1323 

21.20 

0 . 0000 

2399 

1323 

1324 

1239 

21.20 

0 . 0000 

2400 

1240 

1239 

1324 

21.20 

0 . 0000 

2401 

1324 

1325 

1240 

21.20 

0 . 0000 

2402 

1241 

1240 

1325 

21.20 

0 . 0000 

2403 

1325 

1326 

1241 

21.20 

0.0000 

2404 

1242 

1241 

1326 

21.20 

0 . 0000 

2405 

1326 

1327 

1242 

21.20 

0.0000 

2406 

1243 

1242 

1327 

21.20 

0.0000 

2407 

1327 

1328 

1243 

21.20 

0.0000 

2408 

1244 

1243 

1328 

17.20 

0 . 0000 

2409 

1328 

1329 

1244 

14.20 

0 . 0000 

2410 

1245 

1244 

1329 

11.20 

0.0000 

2411 

1329 

1330 

1245 

7.70 

0 . 0000 

2412 

1246 

1245 

1330 

7.70 

0.0000 

2413 

1330 

1331 

1246 

7.20 

0 . 0000 

2414 

1247 

1246 

1331 

7.20 

0 . 0000 

2415 

1331 

1332 

1247 

6.20 

0 . 0000 

2416 

1248 

1247 

1332 

6.20 

0 . 0000 

2417 

1332 

1333 

1248 

4.20 

0 . 0000 

2418 

1249 

1248 

1333 

4.20 

0.0000 

2419 

1333 

1334 

1249 

2.20 

0 . 0000 

2420 

1334 

1250 

1249 

2.20 

0.0000 

2421 

974 

973 

1057 

7.70 

0 . 0000 

1 

2420 

0.45 

2 

2253 

0.45 

3 

2087 

0.45 

4 

1929 

0.45 

5 

1790 

0.45 

6 

1642 

0.45 

7 

1498 

0.45 

8 

1369 

0.45 

9 

1223 

0.45 

10 

1084 

0.45 

11 

949 

0.45 

12 

818 

0.45 

13 

694 

0.45 

14 

594 

0.45 

15 

501 

0.45 

16 

500 

0.45 

17 

499 

0.45 

18 

494 

0  45 

19 

492 

0.45 

20 

490 

0.45 

21 

488 

0.45 

22 

415 

0.45 

23 

482 

0.45 

24 

480 

0.45 

25 

572 

0.45 

26 

569 

0.45 

27 

568 

0.45 

28 

478 

0.45 

29 

479 

0.45 

30 

414 

0.45 

31 

350 

0.45 

32 

351 

0.45 

33 

352 

0.45 

34 

288 

0.45 

35 

228 

0.45 

36 

177 

0.45 

37 

131 

0.45 

38 

89 

0.45 

39 

87 

0.45 

40 

52 

0.45 

41 

50 

0.45 

42 

48 

0.45 

43 

20 

0.45 

44 

7 

0.45 

45 

5 

0.45 

46 

3 

0.45 

47 

1 

0.45 

48 

8 

0.45 

49 

23 

0.45 

50 

21 

0.45 

51 

25 

0.45 

52 

53 

0.45 

53 

90 

0.45 

54 

132 

0.45 

55 

178 

0.45 

56 

230 

0.45 

57 

289 

0.45 

58 

353 

0.45 

59 

416 

0.45 

60 

502 

0.45 

61 

595 

0.45 

62 

712 

0.45 

63 

710 

0.45 

64 

708 

0.45 

65 

706 

0.45 

66 

704 

0.45 

67 

702 

0.45 

68 

700 

0.45 

69 

698 

0.45 

70 

696 

0.45 

71 

695 

0.45 

72 

819 

0.45 

73 

950 

0.45 

74 

1085 

0.45 

75 

1224 

0.45 

76 

1370 

0.45 

77 

1499 

0.45 

78 

1643 

0.45 

79 

1791 

0.45 

80 

1930 

0.45 

81 

2088 

0.45 

82 

2254 

0.45 

83 

1598 

0.45 

84 

1596 

0.45 

85 

1594 

0.45 

86 

1448 

0.45 

87 

1446 

0.45 

88 

1444 

0.45 

89 

1314 

0.45 

90 

1312 

0.45 

91 

1310 

0.45 

92 

1308 

0.45 

93 

1306 

0.45 

94 

1304 

0.45 

95 

1302 

0.45 

96 

1300 

0.45 

97 

1298 

0.45 

98 

1296 

0.45 

99 

1443 

0.45 

100 

1441 

0.45 

101 

1439 

0.45 

102 

1568 

0.45 

103 

1566 

0.45 

104 

1564 

0.45 

105 

1708 

0.45 

106 

1706 

0.45 

107 

1704 

0.45 

108 

1703 

0.45 

109 

1701 

0.45 

110 

1699 

0.45 

111 

1697 

0.45 

112 

1695 

0.45 

113 

1693 

0.45 

114 

1691 

0.45 

115 

1689 

0.45 

116 

1838 

0.45 

117 

1980 

0.45 

118 

1982 

0.45 

119 

1984 

0.45 

120 

1986 

0.45 

121 

1988 

0.45 

122 

1991 

0.45 

123 

1993 

0.45 

124 

1994 

0.45 

125 

2155 

0.45 

126 

1995 

0.45 

127 

1996 

0.45 

128 

1839 

0.45 

129 

1841 

0.45 

130 

1843 

0.45 

131 

1709 

0.45 

132 

1711 

0.45 

133 

1713 

0.45 

134 

1569 

0.45 

135 

1571 

0.45 

136 

1573 

0.45 

137 

1575 

0.45 

138 

1577 

0.45 

139 

1579 

0.45 

140 

1581 

0.45 

141 

1583 

0.45 

142 

1585 

0.45 

143 

1587 

0.45 

144 

1589 

0.45 

145 

1591 

0.45 

146 

1593 

0.45 

147 

1742 

0.45 

148 

1744 

0.45 

149 

1746 

0.45 

150 

1885 

0.45 

151 

2421 

0.45 

152 

1887 

0.45 

153 

2050 

0.45 

154 

2214 

0.45 

155 

2216 

0.45 

156 

2218 

0.45 

157 

2386 

0.45 

158 

2219 

0.45 

159 

2052 

0.45 

160 

2051 

0.45 

161 

1892 

0.45 

162 

1890 

0.45 

163 

1888 

0.45 

164 

1747 

0.45 

BATHSPEC  FEET  0.0  7.70 
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LISTING  FOR 
EXAMPLE 
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02/07/91  COASTAL  MOOELlNC  STSTCM  (CHS):  NAR6C  VERSION  1.0  11:02:31 

-  HARO  ACA1  HARBOR  UES  PLAN  - 

.  CENSPCCS  CARO:  SPECIF ICAT ION  OF  TITLE  ANO  GENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENCLISN 

• 

•••••  CRIOSPCC  CARO:  SPECIFICATION  OF  TNE  FINITE-CLEMENT  GRID 

AGAT .DAT 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  Of  USAGE: 

VALUE: 

NOTES: 

GRTVPE 

TYPE  OF  FINITE-ELEMENT  GRID 

TRiAHG 

•  OMITS 

SYSTEM  Of  UNITS  USED  FOR  TNE  GRIO 

ENGLISH 

NNOO 

NUMBER  OF  GRID  NODES 

13M 

•  NELE 

HLROEft  OF  GRID  CLEMENTS 

2&21 

NOOR 

HUMBER  OF  NODES  ON  SEMICIRCULAR  BOUN  B4 

•  NEL8 

NUMBER  OF  BOUNDARY  ELEMENTS 

164 

NBANO 

BANDWIDTH  OF  GRID 

88 

*  RADIUS 

RADIUS  OF  SEMICIRaE 

263.80 

*••••  PRUINDOU  CARO:  SPECIFICATION  OF  TNE  MODEL  OUTPUT 

VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

■  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

UPRHOO 

PtlHTlNG  OF  NODAL  SOLUTIONS 

SELECT 

•  ♦WLXNOD 

SPECIFIED  MIX  MMKR  OF  OUTPUT  HODCS 

10 

NOOOUT 

NUMBER  OF  NODES  SELECTED  FOR  OUTPUT 

10 

•  WPfBSH 

NMER  OF  SPECIFIED  BASINS 

32 

NAUSN 

SPECIFIED  MAXIMUM  HUMER  OF  RASIMS 

32 

*  MAXELE 

SPECIFIED  MAX  ELBCHTS  IN  AMT  BASIN 

13 

NPtCOF 

PRINTING  OF  COEFFICIENT  SOLUTIONS 

TES 

*  IMUtD 

PRINTING  OF  FINITE  ELEMENT  GRID 

HO 

8AS1H  *  HUMKR  OF 

ELEICMTS 

•  tASIM  *  MMER  Of 

EieCHTS 

1 

6 

2 

13 

3 

13 

4 

13 

5 

6 

6 

6 

7 

6 

8 

6 

9 

6 

10 

6 

11 

13 

12 

13 

13 

13 

14 

15 

15 

13 

16 

13 

17 

13 

18 

13 

19 

13 

20 

13 

21 

13 

22 

13 

23 

15 

24 

13 

25 

6 

26 

6 

27 

6 

28 

5 

29 

13 

30 

6 

31 

6 

52 

6 

WPIBCR  OF  WAVE  CONDITIONS: 

2 

WAVE 

CONDITION  NUMBER:  1 

VARIARIE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

OCSCRIPTIOM  OF  USAGE: 

VALUE: 

NOTES: 

NMEP 

DEEPUATE*  WAVE  4  flC'^T 

*  IwvLP 

WAVE  PERIOD 

8.00 

2DECP 

OEEPUATER  WAVE  ANGLE 

329.70 

• 

WAVE 

CONDITION  NIMER:  2 

VARIA8LC 

DESCRIPTION  OF  USAGE: 

VALUE: 

MOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

lOCCP 

DEEPWATER  WAVE  NEIGNT 

0.00 

•  TKEP 

WAVE  PERIOD 

11.00 

2DEEP 

DEEPWATER  WAVE  ANGLE 

329.70 

• 

VARIARIE 

DESCRIPTION  OF  USAGE: 

VALUE; 

NOTES: 

*  VARIABLE 

MSCRIPTIOH  OF  USAGE: 

VALUE: 

NOTES: 

•UNITS 

FARO 

STSTEM  OF  UNITS  FOR  DCPTM  DATA 
WATER  DEPTH  OF  FAR  REGIOH 

FEET 

7.700 

•  WDATUM 

DATIM  FOR  WATER  KPTNS 

0.00 

MMKR  OF  ELEVATION  CHANGES  « 

0 

VARIARLE 

KSCRtPTION  OF  USAGE: 

VALUE: 

NOTES: 

•  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES; 

SEELCC  KFi.  COEFf.  ALONG  OPEN  COAST  MOtT  0.00000 


INPVI  PMCmiNB  OOMPLETS: 

FATAL  itiOnN  0  UMMIHGt*  0 
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WAVE  COMOIVION 


TNC  DEEP  UATER  WAVE  PAAAMCTERS  FQ«  CASE  1  AAC:  HEICM1«  0.000 


PEAIODb  a. 000 


ANCLE-  U0.700 


SOLUTION  Of  THE  SYSTEM 


MODAL  POINTS 

MOO  A8S0L  PHASE  MOO  AtSOL  PHASE  NOD  A8S0L  PHASE  HOD  ADSOL  PHASE 


0.26 

1.67 

2 

0.28  1.49 

s 

0.21 

2.12 

6 

0.24  1.86 

0 

0.27 

1.28 

10 

0.27  1.11 

13 

0.17 

2.57 

U 

0.20  2.14 

17 

0.26 

1.41 

18 

0.26  1.24 

21 

0.25 

0.91 

22 

0.25  0.95 

25 

0.19  • 

2.79 

26 

0.17  3.09 

29 

0.21 

1.85 

30 

0.22  1.59 

33 

0.24 

0.98 

34 

0.25  1.04 

37 

0.23 

0.68 

38 

0.23  0.70 

41 

0.21 

0.28 

42 

0.21  -0.05 

45 

0.10  ■ 

‘3.13 

46 

0.16  2.74 

49 

0.21 

1.56 

50 

0.23  1.34 

S3 

0.21 

0.73 

54 

0.22  0.00 

57 

0.19 

0.42 

58 

0.21  0.45 

01 

0.20 

-0.13 

62 

0.21  -0.52 

6S 

0.26 

•2.43 

66 

0.22  -2.71 

69 

0.16 

2.26 

70 

0.10  1.86 

73 

0.23 

1.10 

74 

0.22  0.04 

77 

0.19 

0.50 

78 

0.16  0.25 

81 

0.18 

0.07 

82 

O.tt  -0.27 

as 

0.23 

-0.06 

86 

0.24  -0.75 

09 

0.26 

-2.U 

90 

0.22  -2.71 

93 

0.16 

2.26 

94 

0.18  1.85 

97 

0.23 

1.03 

98 

8.23  8.76 

101 

0.16 

0.04 

102 

0.16  0.14 

105 

0.14 

-0.61 

106 

0.16  -0.43 

109 

0.23 

•1.07 

110 

0.26  -1.10 

113 

0.36 

-2.06 

114 

0.32  -2.25 

117 

0.18 

3.11 

110 

0.17  2.07 

121 

0.19 

1.49 

122 

0.21  1.21 

125 

0.23 

0.40 

126 

0.21  0.22 

129 

0.13 

-o.a 

130 

0.13  -0.97 

133 

0.16 

•1.00 

134 

0.19  -1.26 

137 

0.26 

-1.41 

130 

0.28  -1.20 

141 

0.43 

-1.01 

142 

0.41  -1.96 

145 

0.25 

•2.53 

146 

0.21  -2.08 

149 

0.17 

2.22 

150 

0.18  1.84 

153 

0.23 

0.91 

154 

0.25  0.64 

157 

0.24 

•0.12 

158 

0.20  -0.10 

161 

0.14 

•1.07 

162 

0.17  -1.59 

165 

0.19 

*1.56 

166 

0.22  -1.69 

169 

0.28 

•1.49 

170 

0.29  -1.35 

173 

0.45 

•1.76 

174 

0.43  -1.89 

177 

0.28 

•2.33 

178 

0.23  -2.62 

181 

0.20 

2.52 

182 

0.19  2.22 

185 

0.22 

1.17 

186 

0.24  0.08 

189 

0.26 

0.13 

190 

0.28  -0.11 

193 

0.19 

•0.99 

194 

0.20  -1.55 

197 

0.29 

•2.31 

198 

0.26  -2.20 

201 

0.27 

-2.12 

202 

0.27  -1.84 

205 

0.31 

•1.14 

206 

0.32  -0.98 

209 

0.41 

•1.93 

210 

0.36  -2.03 

213 

0.20 

-2.77 

214 

0.19  3.10 

217 

0.20 

2.23 

218 

0.20  1.90 

221 

0.24 

0.06 

222 

0.27  0.61 

225 

0.32 

•0.07 

226 

0.30  '0.36 

229 

0.23 

-1.42 

230 

0.27  -1.90 

233 

0.38 

•2.60 

234 

0.34  -2.55 

237 

0.30 

•2.30 

238 

0.28  -1.74 

241 

1.06 

2.40 

242 

1.03  2.62 

245 

0.17 

3.02 

246 

0.20  -0.06 

249 

0.42 

-0.53 

250 

0.42  -1.93 

253 

0.35 

•1-92 

254 

0.29  -1.99 

257 

0.16 

‘2.90 

250 

0.19  2.92 

261 

0.27 

2.30 

262 

0.21  1.96 

265 

0.25 

0.07 

266 

0.20  0.63 

269 

0.37 

•0.01 

270 

0.35  -0.28 

273 

0.26 

-1.23 

274 

0.29  -1.74 

277 

0.40 

•2.56 

278 

0.46  -2.01 

281 

0.39 

-2.09 

282 

0.45  -3.10 

285 

1.11 

2.60 

286 

1.18  2.48 

289 

0.85 

2.33 

290 

0.86  2.49 

293 

0.12 

•1.54 

294 

0.31  -0.91 

297 

0.41 

-2.29 

298 

0.39  -2.09 

301 

0.27 

•1.01 

302 

0.20  -1.85 

305 

0.14 

2.98 

306 

0.19  2.74 

309 

0.24 

2.19 

310 

0.22  2.07 

313 

0.24 

0.92 

314 

0.28  0.66 

317 

0.41 

0.07 

318 

0.40  -0.17 

321 

0.34 

-1.26 

322 

0.31  -1.49 

325 

0.41 

•2.45 

326 

0.47  -2.72 

329 

0.40 

•3.07 

330 

0.50  3.08 

333 

0.75 

2.60 

334 

0.09  2.52 

537 

1.12 

2.33 

330 

0.98  2.U 

341 

0.60 

2.36 

342 

0.29  2.47 

345 

0.52 

•0.96 

346 

0.69  -0.80 

349 

0.66 

-2.20 

350 

0.00  -2.49 

353 

0.65 

-2.96 

354 

0.64  '2.99 

357 

0.45 

*2.t5 

358 

0.35  -2.55 

361 

0.22 

-i.a 

362 

0.10  -1.35 

365 

0.06 

2.79 

366 

O.U  2.43 

569 

0.29 

2.71 

378 

0.27  2.56 

373 

0.20 

1.51 

374 

0.23  1.00 

577 

0.99 

9.25 

378 

O.U  0.14 

3 

0.20 

1.32 

4 

0.18 

2.49 

7 

0.25 

1.65 

a 

0.27 

1.45 

11 

0.26 

1.14 

12 

0.17 

2.90 

15 

0.23 

1.84 

16 

0.24 

1.61 

19 

0.26 

1.08 

20 

0.25 

0.90 

23 

0.23 

0.72 

24 

0.22 

0.50 

27 

0.16 

2.U 

20 

0.10 

2.18 

31 

0.24 

1.30 

32 

0.25 

1.21 

35 

0.24 

0.06 

36 

0.21 

0.65 

39 

0.22 

0.47 

40 

0.21 

0.21 

43 

0.24 

-2.43 

U 

0.21 

•2.74 

47 

0-17 

2.25 

40 

0.19 

1.07 

51 

0.24 

1.15 

52 

8.23 

0.90 

55 

0.20 

0.59 

56 

0.18 

0.34 

59 

0.19 

0.15 

60 

0.19 

•0.14 

63 

0.22 

-O.U 

U 

0.30 

•2.17 

67 

0.10 

-3.09 

68 

O.U 

2.73 

71 

0.20 

1.53 

72 

0.22 

1.29 

75 

0.21 

0.U 

76 

0.19 

0.42 

79 

O.U 

•O.U 

80 

8.U 

-0.02 

OS 

0.19 

-0.58 

84 

0.20 

-0.72 

07 

0.35 

•2.01 

88 

0.31 

-2.21 

91 

0.18 

-S.U 

92 

O.U 

2.n 

91 

8.19 

1.51 

96 

8.21 

1.25 

99 

8.21 

0.55 

too 

8.19 

0.31 

103 

8.13 

-0.28 

104 

8.13 

-8.82 

107 

0.17 

-•.78 

108 

8.20 

*1.00 

lit 

0.27 

-8.98 

112 

8.48 

-1.89 

115 

0.26 

•2.67 

1U 

8.22 

•2.77 

119 

0.17 

2.24 

120 

O.U 

1.84 

123 

0.22 

8.96 

124 

8.23 

8.78 

127 

0.18 

-8.85 

128 

8.15 

•0.47 

131 

0.15 

-1.48 

132 

8.15 

-1.25 

135 

0.22 

-1.38 

136 

8.24 

•1.28 

139 

0.29 

-1.24 

140 

8.30 

•1.08 

143 

0.36 

-2.10 

U4 

0.31 

•2.28 

147 

0.18 

S.OO 

148 

0.18 

2.56 

151 

0.20 

1.58 

152 

8.21 

1.17 

155 

0.25 

0.41 

156 

0.23 

O.U 

159 

0.17 

•8.51 

160 

O.U 

*1.07 

163 

0.21 

•1.98 

1U 

8.20 

•1.82 

167 

0.25 

•1.72 

168 

0.27 

•1.83 

in 

o.st 

•1.22 

172 

0.31 

•1.09 

175 

0.39 

•2.80 

176 

0.34 

•2.14 

179 

0.20 

•3.00 

180 

0.19 

2.87 

183 

0.19 

1.85 

184 

0.20 

1.53 

187 

0.26 

0.61 

188 

0.27 

0.57 

191 

0.25 

•0.43 

192 

0.21 

•0.50 

195 

0.19 

-1.U 

196 

0.24 

•2.04 

199 

0.23 

•2.00 

200 

0.26 

•2.07 

203 

0.29 

-1.48 

204 

8.29 

•1.37 

207 

0.45 

•1.78 

208 

8.U 

•1.06 

211 

0.30 

-2.17 

212 

0.24 

-2.42 

215 

0.20 

2.76 

216 

0.22 

2.49 

219 

0.20 

1.58 

220 

0.22 

1.19 

223 

0.29 

0.37 

224 

0.30 

0.14 

227 

0.27 

-8.73 

228 

0.23 

•0.08 

231 

0.26 

-2.82 

232 

0.32 

-2.34 

235 

0.29 

-2.37 

236 

0.31 

•2.45 

239 

1.21 

2.60 

240 

1.U 

2.U 

243 

0.00 

2.65 

2U 

O.U 

2.n 

247 

0.33 

•0.63 

2U 

8.43  -8.31 

251 

0.42 

-1.95 

252 

0.40 

•1.91 

255 

0.22 

-2.18 

2U 

0.10  -2.52 

259 

0.22 

2.67 

260 

0.24 

2.52 

263 

0.20 

1.69 

2U 

0.22 

1.25 

267 

0.31 

O.U 

2U 

0.33 

0.17 

271 

0.32 

•0.60 

272 

O.U 

•1.01 

275 

0.34 

•2.U 

274 

0.33 

•2.27 

279 

0.43 

•2.82 

2U 

0.37 

-2.73 

283 

0.29 

•2.15 

284 

0.91 

2.63 

287 

1.10 

2.40 

m 

1.04 

2.32 

291 

0.57 

2.54 

292 

0.25 

2.71 

295 

O.U 

•0.78 

296 

0.55 

•0.70 

299 

0.36 

-1.95 

300 

0.33  -1.06 

303 

0.13 

•2.14 

304 

0.11 

•2.75 

307 

0.24 

2.U 

308 

0.26 

2.59 

311 

0.21 

1.86 

312 

0.21 

1.U 

315 

o.n 

0.41 

3U 

O.U 

0.20 

319 

O.U 

•O.U 

320 

0.35 

•0.02 

323 

0.35 

•1.96 

324 

0.42 

•2.31 

327 

0.54 

-2.99 

328 

0.52 

•S.U 

331 

0.62 

2.83 

332 

O.U 

2.77 

335 

1.06 

2.49 

3U 

1.U 

2.U 

339 

0.83 

2.U 

348 

0.61 

2.13 

343 

0.08 

•i.n 

3U 

0.31  -1.08 

347 

0.94 

-1.59 

su 

8.78 

•1.90 

SSI 

0.48 

'2.72 

352 

8.62  -2.U 

S55 

8.59 

•2.95 

lU 

8.47  -2.72 

559 

8.28 

-2.13 

340 

8.24  -1.78 

363 

8.11 

-1.26 

3U 

8.04  -I.U 

367 

8.21 

2.43 

3U 

f.U 

2.U 

371 

8.23 

2.U 

372 

8.21 

2.11 

375 

0.27 

8.74 

378 

8.33 

0.47 

379 

8.45 

-8.87 

380 

8.U  -8.31 

9-97 
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561 

0.40  • 

0.63 

362 

0.38  • 

t.04 

583 

0.39  • 

1.49 

384 

0.37  ■ 

1.76 

565 

0.42  • 

2.13 

386 

0.49  • 

2.U 

587 

0.48  - 

2.60 

388 

0.55  • 

2.87 

569 

0.60  • 

3.13 

390 

0.59 

5.04 

391 

0.59 

2.95 

392 

0.68 

2.67 

593 

0.76 

2.U 

394 

0.86 

2.38 

395 

0.97 

2.34 

396 

0.97 

2.15 

397 

1.02 

2.15 

398 

0.89 

1.92 

399 

0.78 

1.80 

400 

0.57 

1.66 

401 

0.32 

1.76 

402 

0.30 

2.15 

403 

0.05  - 

1.59 

404 

0.31  • 

1.15 

405 

0.55 

1.10 

406 

0.75  • 

■1.04 

407 

0.90  • 

0.92 

408 

0.78  - 

■1.82 

409 

0.70 

2.10 

410 

0.59  • 

2.38 

411 

0.53  - 

2.60 

412 

0.53  • 

2.93 

415 

0.56 

-3.10 

414 

0.60 

3.11 

415 

0.62 

3.07 

416 

0.59 

3.09 

417 

0.52 

-3.09 

418 

0.44 

•3.07 

419 

0.34 

-5.04 

420 

0.20 

'2.60 

421 

0.13 

•1.54 

422 

0.19 

•0.75 

423 

0.22 

-0.52 

424 

0.20 

'0.34 

425 

0.15 

-0.10 

426 

0.08 

0.56 

427 

0.08 

1.78 

428 

0.15 

2.39 

429 

0.22 

2.63 

430 

0.29 

2.77 

431 

0.33 

2.86 

432 

0.30 

2.74 

433 

0.26 

2.52 

454 

0.22 

2.42 

435 

0.18 

1.83 

436 

0.21 

1.16 

457 

0.25 

0.85 

458 

0.33 

0.54 

439 

0.40 

0.33 

440 

0.46 

0.24 

U1 

0.50 

0.04 

U2 

0.49 

-0.17 

443 

0.46 

-0.45 

U4 

0.43 

'0.79 

U5 

0.42 

•1.23 

446 

0.45 

-1.66 

447 

0.43 

•1.93 

448 

0.50 

'2.26 

449 

0.56 

•2.54 

450 

0.55 

•2-72 

451 

0.60 

-2.97 

452 

O.U 

3.05 

453 

0.64 

2.89 

454 

0.65 

2.77 

455 

0.7D 

2.53 

456 

0.72 

2.29 

457 

0.79 

2.22 

458 

0.89 

2.19 

459 

0.86 

1.96 

460 

0.90 

1.94 

461 

0.80 

1.66 

462 

0.74 

1.62 

463 

0.59 

1.53 

464 

0.37 

1.38 

465 

0.27 

0.59 

466 

0.14 

0.60 

467 

0.04 

0.32 

468 

0.27 

-1.12 

469 

0.54 

•1.20 

470 

0.76 

•1.20 

471 

0.93 

-1.17 

472 

1.08 

'1.03 

473 

0.54 

•2.17 

474 

0.44 

•2.48 

475 

0.37 

•2.77 

476 

0.34 

'3.09 

477 

0.37 

2.91 

478 

0.43 

2.78 

479 

0.49 

2.73 

480 

0.54 

2.75 

461 

0.55 

2.77 

482 

0.52 

2.87 

483 

0.46 

2.86 

484 

0.37 

2.U 

465 

0.19 

3.01 

486 

0.03 

•1.74 

487 

0.21 

•0.20 

488 

0.35 

-0.07 

469 

0.41 

0.01 

490 

0.39 

0.11 

491 

0.31 

0.28 

492 

0.19 

0.67 

493 

0.13 

1.50 

494 

0.17 

2.50 

495 

0.24 

2.70 

496 

0.32 

2.91 

497 

0.37 

3.02 

490 

0.34 

2.93 

499 

0.29 

2.75 

500 

0.26 

2.73 

501 

0.19 

2.21 

502 

0.18 

1.41 

503 

0.22 

1.04 

504 

0.31 

0.66 

505 

0.40 

0.42 

506 

0.47 

0.34 

507 

0.53 

0.17 

see 

0.54 

-0.03 

509 

0.52 

*0.28 

510 

0.49 

-0.57 

511 

0.46 

•0.99 

512 

0.47 

-1.42 

513 

0.52 

*1.83 

514 

0.50 

-2.06 

515 

0.57 

•2.37 

516 

0.63 

•2.63 

517 

0.61 

•2.81 

518 

0.64 

•3.06 

519 

0.65 

2.95 

520 

0.65 

2.79 

521 

0.67 

2.64 

522 

0.68 

2.39 

523 

0.66 

2.12 

524 

0.72 

2.03 

525 

0.79 

1.99 

526 

0.75 

1.71 

527 

0.80 

1.71 

528 

0.74 

1.39 

529 

0.71 

1.31 

530 

0.62 

1.23 

531 

8.46 

1.06 

532 

0.35 

0.S6 

553 

0.24 

-0.16 

554 

0.22 

-0.42 

535 

0.22 

-0.89 

536 

0.48 

•1.25 

537 

0.73 

-1.34 

538 

0.97 

-1.35 

539 

1.10 

-1.32 

540 

1.26 

•1.22 

541 

0.40 

•3.12 

542 

0.29 

2.91 

543 

0.23 

2.46 

5U 

0.24 

2.07 

545 

0.29 

1.90 

546 

0.35 

1.93 

547 

0.40 

2.07 

548 

0.46 

2.23 

549 

0.49 

2.38 

550 

0.50 

2.51 

551 

0.47 

2.54 

552 

0.40 

2.54 

553 

0.26 

2.58 

554 

0.07 

1.91 

555 

0.20 

0.13 

556 

0.41 

0.06 

557 

0.57 

0.10 

558 

0.62 

0.15 

559 

0.60 

0.25 

560 

0.49 

0.40 

561 

0.29 

0-72 

562 

0.17 

1.45 

563 

0.18 

2.34 

564 

0.27 

2.U 

565 

0.35 

3.06 

566 

0.42 

•3.09 

567 

0.40 

3.12 

568 

0.34 

2.99 

569 

0.52 

3.01 

570 

0.21 

2.65 

571 

0.16 

1.82 

572 

0.18 

1.32 

573 

0.26 

0.80 

574 

0.39 

0.54 

575 

0.48 

0.49 

576 

0.56 

0.30 

577 

0.60 

0.13 

578 

0.59 

•0.09 

579 

0.56 

•0.36 

580 

0.52 

•0.72 

561 

0.51 

•1.11 

582 

0.54 

•1.55 

583 

0.6A 

•1.91 

584 

0.58 

•2.16 

565 

0.64 

•2.45 

586 

0.68 

-2.70 

587 

0.66 

•2.88 

588 

0.67 

3.13 

569 

0.65 

2.86 

590 

0.64 

2.68 

591 

0.65 

2.53 

592 

0.63 

2.25 

593 

0.60 

1.91 

594 

0.65 

1.81 

595 

0.70 

1.76 

596 

0.69 

1.U 

597 

0.72 

1.41 

598 

0.71 

1.08 

599 

0.71 

1.08 

600 

0.66 

1.00 

601 

0.53 

0.87 

602 

0.44 

0.49 

603 

0.29 

0.03 

604 

0.28 

-0.98 

605 

0.39 

*1.22 

606 

0.64 

•1.46 

607 

0.89 

•1.54 

608 

1.12 

-1.56 

609 

1.40 

•1.46 

610 

0.47 

2.00 

611 

0.37 

2.29 

612 

0.34 

1.U 

613 

0.40 

1.23 

614 

0.50 

1.04 

615 

0.50 

1.12 

616 

0.48 

1.29 

617 

0.45 

1.56 

618 

0.45 

1.09 

619 

0.46 

2.15 

620 

0.46 

2.29 

621 

0.43 

2.39 

622 

0.32 

2.45 

623 

0.15 

2.14 

624 

0.16 

0.41 

625 

0.40 

0.10 

626 

0.61 

0.10 

627 

0.76 

0.15 

628 

0.80 

0.21 

629 

0.76 

0.32 

630 

0.63 

0.46 

631 

0.39 

0.74 

632 

0.19 

1.U 

633 

0.19 

2.50 

634 

0.30 

5.00 

635 

0.40 

-3.05 

636 

0.48 

'2.92 

637 

0.46 

•2.99 

638 

0.41 

•5.09 

639 

0.39 

•3.05 

640 

0.27 

2.90 

641 

0.17 

2.36 

642 

0.15 

1.86 

643 

0.24 

1.03 

6U 

0.57 

0.69 

645 

0.47 

0.67 

646 

0.58 

0.49 

647 

8.64 

0.32 

648 

0.66 

0.12 

649 

0.63 

•0,11 

650 

0.59 

•0.42 

651 

0.56 

•0.82 

652 

8.57 

-1.23 

653 

0.65 

•1.63 

654 

0.70 

•1.95 

655 

0.67 

•2.22 

656 

0.72 

-2.49 

657 

0.75 

•2,74 

658 

0.70 

-2.95 

659 

0.68 

3.06 

660 

8.U 

2.77 

661 

0.61 

2.58 

662 

0.61 

2.39 

663 

0.58 

2.05 

6U 

8.56 

1.U 

665 

0.60 

1.53 

666 

0.64 

1,47 

667 

0.66 

1.12 

668 

0.69 

1.09 

669 

0.72 

0.79 

670 

0.73 

0.78 

671 

0.72 

0.72 

672 

0.63 

0.66 

673 

0.50 

0.41 

674 

0.40 

0.22 

675 

0.23 

•0.42 

676 

0.29 

•1.53 

677 

0.48 

-1.54 

678 

0.73 

•1.74 

679 

1.01 

-1.82 

680 

1.24 

'1.U 

681 

1.50 

•1,74 

682 

0.58 

2.95 

683 

o.a 

2.28 

684 

0.43 

1.47 

685 

0.57 

0.96 

686 

0.71 

0,75 

687 

0.77 

0.68 

688 

0.75 

0.69 

669 

0.67 

0.78 

690 

0.54 

0.99 

691 

o.u 

1.36 

692 

0.41 

1.81 

693 

0.42 

2.13 

694 

0.43 

2.57 

695 

0.38 

2.50 

696 

0.22 

2.45 

697 

0.08 

0.96 

698 

0.31 

0.00 

699 

0.56 

0.04 

700 

0.75 

0.09 

701 

0.86 

0.16 

702 

0.89 

0.24 

703 

0.84 

0.38 

704 

0.71 

0.52 

m 

0.43 

0.79 

706 

0.21 

1.U 

707 

0.21 

2.71 

708 

0.33 

-3.10 

709 

0.45 

•2.88 

710 

0.54 

-2.77 

711 

0.54 

•2.82 

712 

0.48 

•2.91 

713 

0.49 

-2.82 

714 

0.57 

•2.99 

715 

0.22 

2.91 

716 

0.16 

2.65 

717 

0.19 

1.42 

718 

0.34 

0.90 

719 

0.43 

0.89 

720 

0.56 

0.69 

721 

0.64 

0.52 

722 

0.68 

0.33 

723 

0.67 

0.13 

724 

0.63 

•O.U 

725 

0.59 

-0.52 

726 

0.58 

•0.92 

727 

0.62 

•1.33 

728 

0.69 

-1.66 

729 

0.76 

•1.98 

730 

0.77 

-2,22 

m 

0.80 

•2.49 

732 

0.80 

•2.74 

733 

0.74 

-2.99 

734 

0.69 

5.00 

735 

0.63 

2.69 

736 

0.58 

2.43 

737 

0.57 

2.22 

738 

0.54 

1.80 

739 

0.55 

1.32 

740 

0.58 

1.21 

741 

0.62 

1.13 

742 

0.67 

0.78 

745 

0.70 

0.78 

7U 

0.75 

0.50 

745 

0.76 

0.53 

746 

0,75 

0.51 

747 

0.71 

0.49 

748 

0.69 

0.31 

749 

0.53 

0.26 

750 

0.30 

0.08 

751 

0.11 

•1.06 

752 

0.32 

•2.30 

753 

0.54 

•1.97 

754 

0.83 

-2.12 

755 

1.14 

•2.19 

756 

1.39 

-2.18 

757 

1.61 

•2.11 

758 

0.65 

'2.96 

759 

0.52 

2.70 

760 

0.39 

1.48 

761 

0.64 

0.77 

762 

0.89 

0.53 

763 

1.00 

O.U 

7U 

1.00 

0.42 

765 

0.88 

0.45 

766 

0.68 

0.56 

767 

0.45 

0.86 

768 

0.53 

1.U 

769 

0.54 

2.11 

770 

0.43 

2.51 

771 

0.44 

2.U 

772 

0.32 

2.73 

773 

0.11 

2.71 

774 

0.15 

•0.15 

775 

0.41 

•8.12 

776 

O.U 

-0.05 

777 

0.78 

0.04 

778 

0.83 

O.H 

779 

o.« 

8.27 

780 

0.85 

O.U 

781 

0.72 

0.60 

782 

0.44 

0.89 

783 

0.21 

1.53 

714 

0.22 

2.91 

785 

0.38 

•2.90 

786 

0.51 

-2,72 

787 

0.64 

-2.57 

788 

O.U 

-2.63 

789 

0.59 

•2.71 

790 

0.61 

•2.59 

791 

0.47 

•2.72 

792 

0.51 

•2.95 
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NOO  ABSOl  PHASe 


NODAL  POINTS 

WOO  ASSOL  PHASe  WOO  A8^  PHASE 


NOD  A8SOL  PHASE 


797 

0.84 

0.58 

798  1 

0.84  •> 

0.70 

799 

0.76  - 

0.64  1 

SOO  1 

0.63  • 

1.02 

aoi 

0.48  ■ 

1.36 

802 

0.40  - 

1.90 

605 

0.45  - 

2.45 

804 

0.55  • 

2.75 

eos 

0.65  • 

2.93 

806 

0.71  - 

3.03 

807 

0.72  - 

3.11 

808 

0.61  • 

2.25 

809 

0.82  • 

2.50 

810 

0.80  • 

2.75 

811 

0.76  - 

3.00 

812 

0.69 

2.97 

813 

0.60 

2.56 

814 

0.56 

2.26 

815 

0.54 

2.02 

816 

0.53 

1.50 

817 

0.59 

1.00 

818 

0.61 

0.89 

819 

0.64 

0.82 

820 

0.73 

0.47 

821 

0.74 

0.49 

822 

0.81 

0.25 

623 

0.80 

0.29 

824 

0.79 

0.32 

825 

0.76 

0.33 

826 

0.74 

0.20 

827 

0.63 

0.23 

828 

0.42 

0.25 

829 

0.16 

0.33 

830 

O.U 

3.12 

831 

0.48  - 

3.02 

832 

0.63  - 

2.50 

833 

0.99  - 

2.54 

834 

1.34  • 

2.58 

835 

1.77  • 

2.47 

836 

1.36  • 

2.78 

837 

0.84 

3.11 

838 

0.31 

2.09 

839 

0.57 

O.U 

840 

0.96 

0.35 

641 

1.16 

0.25 

842 

1,20 

0.19 

643 

1,08 

0.18 

8U 

0.81 

0.21 

845 

0.47 

0.37 

846 

0.23 

0.95 

847 

0,25 

2.34 

848 

O.U 

2.74 

849 

0.52 

2.83 

850 

0.46 

2.93 

851 

0.20 

3.12 

852 

0.09  • 

2.04 

653 

0.27  • 

0.56 

854 

0.49  • 

0.32 

855 

0.64  • 

•0.17 

856 

0.72  • 

■0.03 

857 

0.72 

0.16 

858 

0.75 

0.32 

859 

0,80 

0.55 

860 

0.70 

0.73 

861 

0.41 

1.04 

862 

0.19 

1.78 

863 

0.25 

•3.07 

8U 

O.U  • 

2.67 

865 

0.60  - 

2.49 

866 

0.72 

2.37 

867 

0.73 

2.45 

868 

0.69 

-2.50 

869 

0.67  ■ 

2.41 

870 

0.55 

2.51 

871 

0.40 

•2.U 

872 

0.50 

O.U 

873 

0.53 

0.16 

874 

0.64 

•0.20 

875 

0.75 

•0.57 

876 

0.82 

•0.73 

877 

0.82  • 

•0.85 

878 

0.74 

-0.98 

879 

8.60 

•1.17 

880 

O.U 

•1.51 

881 

0.38 

•2.05 

882 

0.41 

•2.53 

883 

0.48 

•2.84 

884 

0.58 

-3.02 

885 

0.64 

•3.13 

886 

0.69 

3.08 

887 

0.69 

3.02 

888 

8.68 

3.07 

889 

0.63 

2.94 

890 

0,57 

2.71 

091 

0.74 

•3.02 

892 

O.U 

2.90 

893 

0.59 

2.58 

894 

0.54 

2.08 

895 

0.53 

1.76 

096 

0.58 

1.20 

897 

0.66 

0.75 

898 

0.69 

0.59 

099 

0.71 

0.50 

900 

0.82 

0.21 

901 

0.82 

0.21 

902 

0.88 

•0.01 

903 

0.85 

0.05 

904 

0.82 

0.12 

90S 

0.78 

0.17 

906 

0.72 

0.08 

907 

0.63 

0.15 

908 

0.45 

0.32 

909 

0.24 

0.64 

910 

0.26 

2.23 

911 

0.56 

2.73 

912 

8.81 

•3.00 

913 

1.23 

-2.97 

914 

1.61 

•2.95 

915 

1.97 

-2.79 

916 

1.90 

•2.78 

917 

1.28 

-3.10 

918 

0.49 

2.76 

919 

0.40 

0.61 

920 

8.94 

0.19 

921 

1.25 

0.07 

922 

1.S5 

0.00 

923 

1.24 

•0.06 

924 

8.94 

•8.89 

925 

0.53 

•0.12 

926 

O.U 

•o.os 

927 

0.23 

2.94 

928 

8.52 

2.98 

929 

0.64 

2.96 

930 

0.62 

3.03 

«1 

0.48 

-3.11 

9S2 

0.29 

•2.72 

933 

0.21 

-1.53 

934 

9.38 

•0.79 

935 

8.52 

-0.53 

936 

8.58 

-8.35 

937 

0.56 

•0.14 

938 

0.50 

0.15 

939 

8.56 

0.38 

940 

8.7S 

0.69 

9S1 

0.66 

0.89 

942 

8.43 

1.16 

943 

8.17 

2.19 

9U 

8.29 

-2.77 

96S 

0.49 

•2.45 

946 

0.69 

•2.31 

947 

8.73 

-2.21 

948 

0.76 

-2.27 

969 

0.74 

•2.34 

9S0 

8.80 

1.47 

951 

8.71 

1.34 

952 

8.59 

1.11 

953 

0.47 

0.55 

954 

0.49 

0.00 

955 

8.60 

-8.39 

956 

8.68 

-0.77 

957 

0.75 

•0.90 

958 

0.75 

-1.02 

959 

8.67 

•1.15 

960 

8.54 

•1.33 

961 

0.39 

•1.67 

962 

0.31 

-2,31 

963 

8.SS 

•2.84 

9U 

O.U 

•S.U 

965 

0.53 

2.99 

966 

0.58 

2.91 

967 

8.61 

2.09 

966 

8.61 

2.87 

969 

0.63 

2.89 

970 

0.S8 

2.77 

971 

8.SS 

2.53 

972 

0.54 

2.33 

973 

0.61 

1.81 

974 

0.69 

1.S6 

975 

8.55 

1.87 

976 

0.56 

1.50 

977 

0.67 

0.97 

978 

0.83 

0.52 

979 

1.82 

8.13 

980 

0.83 

0.35 

981 

0.83 

0.24 

982 

0.94 

•0.03 

963 

8.91 

-0.03 

984 

0.94 

•0.18 

985 

0.89 

-0.14 

986 

0.83 

•0.08 

907 

8.77 

-0.01 

918 

0.68 

-8.01 

989 

0.59 

0.11 

990 

0.47 

O.SS 

991 

8.33 

0.95 

992 

0.40 

1.89 

993 

0.68 

2.35 

994 

0.96 

2.00 

995 

1.35 

2.91 

996 

1.75 

3.01 

997 

2.12 

-3.07 

998 

2.55 

•2.85 

999 

1.72 

•3.11 

1000 

0.87 

2.92 

tool 

0.20 

1.45 

1002 

0,57 

0.22 

1005 

8.99 

0.02 

1004 

1.34 

•0.10 

1005 

1.U 

-0.17 

1006 

1.31 

•0.24 

1007 

0.98 

•0.32 

1008 

0.57 

-0,45 

1009 

0.18 

•1.04 

1010 

0.33 

•3.02 

1011 

0.62 

3.07 

1012 

0.75 

3.01 

1013 

0,72 

3.06 

1014 

0.58 

•3.06 

1015 

0.39 

*2.68 

1016 

0.31 

•1.88 

1017 

0.40 

•1.21 

1018 

0.48 

•0.96 

1019 

8.52 

•8.75 

1020 

0.50 

-0.54 

1021 

0.39 

•0.31 

1022 

0.21 

•0.01 

1023 

0.02 

1.78 

1024 

O.U 

•3.09 

1025 

0.59 

-3.00 

1026 

0.60 

-2,90 

1027 

8.51 

•2.81 

1028 

0.37 

•2.76 

1029 

0.19 

-2.90 

1030 

0.11 

2.Z3 

1031 

8.74 

1.50 

1032 

0.82 

1.51 

1033 

0.78 

1.37 

1034 

0.68 

1.23 

1035 

0.55 

0.99 

1036 

0.37 

0.43 

1037 

0.40 

-0.25 

1036 

0.51 

•0.67 

1039 

8.60 

-1.01 

1040 

0.67 

•1,14 

1041 

0.66 

•1,24 

1042 

0.57 

•1.36 

1043 

0.42 

•1.57 

10U 

0.28 

•2.02 

1045 

0.24 

-2.88 

1046 

0.32 

2.08 

1047 

8.41 

2.71 

1048 

0.48 

2.60 

1049 

0.50 

2.59 

1050 

0.50 

2.63 

1051 

8.46 

2.66 

1052 

0.50 

2.71 

1053 

0.47 

2.61 

1054 

0.44 

2.38 

1055 

8.58 

2.10 

1056 

0.57 

1.73 

1057 

0,71 

1.45 

1056 

0.64 

1,29 

1059 

8.62 

1.29 

1060 

0.77 

0.81 

1061 

0.97 

0.37 

1062 

1.13 

-0.02 

1063 

8.98 

0.01 

10U 

1.05 

•0.23 

1065 

1.01 

-0.27 

1066 

0.99 

•0.37 

1067 

0.92 

•0.35 

1068 

0.8S 

•0.29 

1069 

0.74 

•0.20 

1070 

0.63 

•0.12 

1071 

0.54 

0.06 

1072 

0.45 

0.37 

1073 

0.40 

0.94 

1074 

0.53 

1.67 

1075 

0.78 

2.03 

1076 

1.09 

2.37 

1077 

1.44 

2.57 

1078 

1.85 

2.71 

1079 

2.11 

2.93 

1080 

2.72 

•2.95 

1081 

2.09 

3.06 

1082 

1.30 

2.85 

1063 

0.42 

2.34 

1064 

0.52 

0.20 

1085 

1.07 

•0,13 

1086 

1.40 

-0.27 

1067 

1.51 

-0.37 

1068 

1.37 

-0.49 

1089 

1.06 

•0.62 

1090 

0.63 

•0.88 

1091 

0.31 

-1.81 

1092 

0.52 

-2.95 

1093 

0.76 

3.09 

1094 

0.89 

5.02 

1095 

0.84 

3.05 

1096 

0.68 

-3.10 

1097 

0.48 

•2.76 

1098 

0.39 

•2.04 

1099 

0.46 

•1.45 

1100 

0.54 

-1.18 

1101 

0.53 

•1.00 

1102 

0.42 

•0.87 

1103 

0.23 

•0.74 

1104 

0.03 

•1.65 

1105 

0.28 

3.07 

1106 

0.52 

-3,14 

1107 

0.61 

-3.11 

1108 

0.50 

•3.01 

1109 

0.48 

•2.91 

1110 

0.33 

-2.85 

1111 

0.17 

-2.94 

1112 

0.09 

1.85 

1113 

0.31 

1.49 

1114 

0.56 

1.U 

1115 

0.75 

1.40 

1116 

0.78 

1.36 

1117 

0.72 

1.28 

1118 

0.58 

1.16 

1119 

0.40 

0.89 

1120 

0.24 

0.20 

1121 

0.28 

•0.74 

1122 

0.42 

•1.17 

iia 

0.53 

•1.35 

1124 

0.58 

•1.48 

1125 

0.55 

•1.57 

1126 

O.U 

-1.73 

1127 

0.30 

•2.05 

1128 

0.20 

•2.78 

1129 

0.26 

2.62 

1130 

0.37 

2.28 

1131 

0.45 

2.15 

1132 

0.47 

2.06 

1133 

0.44 

2.11 

1134 

0.38 

2.18 

1135 

0.32 

2.32 

1136 

0.29 

2.45 

1137 

0.28 

2.43 

1138 

0.30 

2.21 

1139 

0.39 

1.83 

1140 

0.53 

1.55 

1UI 

0.70 

1,32 

1142 

0.86 

1.15 

1143 

0.98 

1.00 

11U 

1.07 

0.73 

1145 

1.14 

0.40 

1146 

1.11 

0.07 

1147 

1.26 

•0.20 

1148 

1.31 

-O.U 

1149 

1.18 

•0.28 

1150 

1.16 

-0.42 

1151 

1.11 

-0.49 

1152 

1.03 

-0.54 

1153 

0.93 

•0.54 

1154 

0.81 

-0.52 

1155 

0.66 

•0.43 

1156 

0.56 

-0.29 

1157 

0.46 

•0.01 

1156 

0.41 

0.36 

1159 

0.43 

0.91 

1160 

0.61 

1.U 

1161 

0.88 

1.77 

1162 

1.16 

1.97 

1163 

1.47 

2.14 

IU4 

1.85 

2.33 

1165 

2.13 

2.62 

1166 

2.83 

3.12 

1U7 

2.36 

2.82 

1168 

1.U 

2.60 

1169 

0.59 

2.07 

1170 

0.55 

0.25 

1171 

1.07 

-0.22 

1172 

1.U 

•0.41 

1173 

1.54 

•0.56 

1174 

1.39 

-0.72 

1175 

1.06 

•0.93 

1176 

0.68 

•1.39 

1177 

0.54 

•2.34 

1178 

0.76 

-2.99 

1179 

0.99 

3.03 

1180 

1.84 

2.94 

1181 

0.93 

2.94 

1182 

0.68 

3.09 

1163 

0.45 

•2.73 

1184 

0.43 

•1.08 

1185 

0.57 

-1.48 

1186 

0.64 

♦1,32 

1187 

8.58 

-1.28 

1188 

8.41 

•1.36 

1189 

0.20 

•1.93 

1190 

0.24 

•3,10 

1191 

O.U 

2.91 

1192 

8.59 

2.91 

1193 

0.62 

2.98 

1194 

0.55 

3.09 

1195 

8.42 

•3.82 

1196 

8.25 

•2.78 

1197 

0.10 

-2.51 

1198 

0.07 

0.79 

1199 

8.27 

1.U 

1280 

8.47 

1.20 

1201 

0.63 

1.23 

1202 

0.67 

1.23 

1203 

0.61 

1.21 

1284 

O.U 

.  1.17 

1205 

0.24 

1.02 

1206 

0.06 

•0.56 

1207 

8.25 

•1.89 

MOi 

8.42 

•1.01 

1209 

0.52 

•1.87 

1210 

0.54 

•1.96 

1211 

8.41 

•2.09 

1212 

8.37 

’  -2.33 
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MODAL  K>|HTS 

MOD  AASa  f>MASE  NOD  ADSOL  MASC  MOO  AISOL  MUSE  MOD  AtSOL  PHASE 


1213  0.27  -2.87  12U  0.28  2.S7  1215  0.42  2.0S  1216  0.53  1.82 
1217  0.59  1.65  1218  0.58  1.52  1219  0.48  1.57  1220  0.54  1.20 
1221  0.21  0.90  1222  0.09  0.51  1225  0.04  -0.05  1224  0.05  1.11 


1225 

0.19 

1.28 

1226 

0.39 

1.19 

1227 

0.62 

1.05 

1228 

0.84 

0.91 

1229 

1.01 

0.72 

1250 

1.09 

0.46 

1251 

1.17 

0.10 

1252 

1.27 

-0.14 

1253 

1.57 

-0.40 

1254 

1.42 

•0.62 

1255 

1.33 

-0.67 

1256 

1.23 

•0.74 

1237 

1.11 

-0.81 

1258 

0.96 

•0.85 

1259 

0.79 

-0.85 

1240 

0.61 

-0.79 

1241 

0.44 

-0.60 

1242 

0.35 

-0.19 

1243 

0.52 

0.42 

1244 

0.42 

0.92 

1245 

0.64 

1.23 

1246 

0.92 

1.41 

1247 

1.17 

1.51 

1248 

1.39 

1.61 

1249 

1.64 

1.77 

1250 

1.81 

2.07 

1251 

2.89 

2.79 

1252 

2.25 

2.47 

1253 

1.56 

2.27 

1254 

0.79 

1.77 

1255 

0.63 

0.55 

1256 

1.07 

-0.25 

1257 

1.43 

•0.52 

1258 

1.52 

•0.72 

1259 

1.57 

-0.95 

1260 

1.05 

-1.26 

1261 

0.78 

•1.84 

1262 

0.77 

•2.60 

1263 

0.99 

-3.15 

1264 

1.16 

2.91 

1265 

1.14 

2.78 

1266 

0.94 

2.73 

1267 

0.58 

2.84 

1266 

0.27 

-2.72 

1269 

0.42 

-1.53 

1270 

0.64 

-1.53 

1271 

0.73 

-1.52 

1272 

0.64 

-1.40 

i2n 

0.42 

-1.65 

1274 

0.26 

•2.56 

1275 

0.40 

2.88 

1276 

0.58 

2.68 

1277 

0.66 

2.67 

1278 

0.60 

2.74 

1279 

0.46 

2.90 

1280 

0.29 

-5.06 

1281 

0.17 

-2.37 

1282 

0.14 

-1.40 

1283 

0.15 

-0.41 

1284 

0.25 

0.58 

1285 

0.37 

0.82 

1286 

0.50 

1.01 

1287 

0.52 

1.09 

1288 

O.U 

1.13 

1289 

0.28 

1.20 

1290 

0.07 

1.78 

1291 

0.18 

-2.58 

1292 

0.39 

-2.28 

1293 

0.52 

•2.28 

1294 

0.58 

-2.50 

1295 

0.57 

-2.40 

1296 

0.50 

-2.55 

1297 

0.40 

-2.90 

1298 

0.35 

2.83 

1299 

0.42 

2.25 

1300 

0.57 

1.83 

1501 

0.70 

1.58 

1502 

0.76 

1.37 

1303 

0.75 

1.17 

1504 

0.65 

O.BB 

1305 

0.53 

0.51 

1306 

0.47 

0.02 

1307 

0.41 

-0.47 

1508 

0.59 

-0.86 

1309 

0.31 

-1.05 

1310 

0.16 

-0.85 

1311 

0.17 

0.56 

1512 

0.45 

0.84 

1513 

0.70 

0.74 

1314 

0.91 

0.53 

1315 

1.06 

0.28 

1516 

1.20 

-0.10 

1317 

1.40 

-0.51 

1318 

1.49 

-0.75 

1319 

1.43 

•0.88 

1520 

1.54 

-0.98 

1321 

1.19 

•1.08 

1522 

1.01 

-1.19 

1323 

0.81 

-1.26 

1324 

0.57 

-1.28 

1525 

0.35 

-1.23 

1526 

0.17 

-0.66 

1327 

0.20 

0.60 

1528 

0.56 

0.96 

1529 

0.59 

1.05 

1550 

0.88 

1.07 

1331 

1.15 

1.03 

1532 

1.50 

0.97 

1333 

1.45 

0.90 

1554 

1.43 

1.05 

0 

0.00 

0.00 

0 

0.00 

0.00 
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rCK  THE  8AS1N  «  1 


1HC  101AI  MCA  * 
THE  MEAN  SO«T  VALUE  OVCA  THE  AASIN  - 


FOB  THE  tASm  «  2 

IHE  lOfAL  AKA  • 
THE  MEAN  SORT  VALUE  OVER  TK  tASlM  « 


ECS  THE  lASlM  «  3 

TNC  fOfAL  AREA  • 
TME  MEAN  SORT  VALUE  OV^R  THE  RASIM  ■ 


FOR  THE  RASIM  ■  A 

TME  TOTAL  AREA  » 
THE  MEAN  SORT  VALUE  OVER  THE  RAStM  « 


FOR  THE  RASIM  >  5 

THE  TOTAL  AREA  > 
THE  MEAN  SORT  VALlC  OVER  THE  RASIM  « 


FOR  TME  RASIM  *  6 

THE  TOTAL  AREA  * 
THE  ICAM  SORT  VALUE  OVER  TME  RASIM  • 


FOR  THE  RASIM  «  7 

TME  TOTAL  AREA  « 
THE  MEAM  SORT  VALUE  OVER  THE  RASIM  • 


TOR  THE  RASIH  •  R 

THE  TOTAL  AREA  • 
TME  REAM  SORT  VALUE  OlffR  THE  RASIH  • 


MR  TME  RASIH  •  R 

THE  TOTAL  AREA  • 
THE  ICAM  SORT  VALUE  €Nn  THE  RASIH  • 


MR  THE  RASIH  ■  10 

TIC  TOTAL  AREA  ■ 
TME  MEAM  SORT  VALUE  OVER  THE  RASIH  • 


MR  TME  RASIH  •  11 

IHE  TOTAL  AREA  « 
THE  ICAM  SORT  VALUE  OVER  TME  RASIH  « 


FOR  THE  RASIM  •  12 

TME  TOTAL  AREA  « 
TNC  FCAM  SORT  VALUE  OVER  THE  RASIH  • 


r0>  THE  RASIH  •  13 

THE  TOTAL  AREA  > 
TNC  MEAN  SORT  VALUE  OVER  THE  BASIM  • 


FOR  THE  RASIM  •  U 

THE  TOTAL  AREA 
TNE  MEAM  SOiT  VALUE  OVER  THE  RASIH 


FOR  THE  RASIH  •  13 

THE  TOTAL  AREA 
TNE  MEAM  SORT  VALUE  OVER  THE  RASIH 


FOR  THE  RASIM  ■  10 

TNE  TOTAL  AREA 
THE  MEAN  SORT  VALUE  OVER  TNE  HASIM 


FOR  THE  RASIM  •  17 

INC  TOTM.  AREA 
IMC  MEAN  SORT  VALUE  OVER  THE  RASIM 


FOR  THE  RASIM  •  16 

THE  TOTAL  AREA 
THE  MEAN  SORT  VALUE  OVER  TME  RASIM 


FOR  TNE  RASIM  ■  19 

the  TOTAL  AREA 
THE  MEAN  SORT  VALUE  OVER  TNE  RASIM 


FOR  TNC  RASIM  >  20 

TME  TOTAL  AREA 
TNC  MEAM  SORT  VALUE  OVER  TIC  RASIM 


FOR  TIC  RASIH  •  21 

THE  TOTAL  AREA 
TIC  REAM  SORT  VALUE  OVU  THE  RASIH 


Mi  THE  RASIH  •  22 

THE  TOTAL  AICA 
THE  mm  flORT  VALUE  OICR  TIC  RASIH 


0.2121C*03 

0.6996 


0.A739CM3 

0.6299 


0.4349CM5 

0.6332 


O.U97E*OS 

O.S6AR 


0.2069EM3 

0.3943 


0.2091EM3 

0.4343 


R.190RCM3 

0.3936 


0.19R7EM3 

R.1932 


0.2037t««3 

R.S397 


0.2317EM3 

0.3951 


0.4R2SEM3 

0.22R7 


0.4129EM3 

0.2123 


0.4010CM3 

0.2766 


0.4440EMS 

0.2339 


0.446SCMS 

0.3323 


0.4409CM3 

0.1761 


0.4173CH)3 

0.1RS2 


0.40R5CM3 

0.2160 


0.i142C*03 

0.1782 


•  R.3045CM3 
■  0.1613 


«  0.4S21CM3 
-  0.3373 


•  0.40i6E«03 

•  0.2096 
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FOR  IKC  lASIM  >  23 


THE  TOTAi  AREA  « 
THE  MEAN  SORT  VALUE  OVER  TNE  iASlN  - 

FOR  TNE  lASIM  •  24 

TNE  TOTAL  AREA  • 
TNE  MEAN  SORT  VALUE  OVER  TNE  RASIM  • 

FOR  TNE  RASIM  >  25 

TNE  TOTAL  AREA  • 
THE  MEAN  SORT  VALUE  OVER  THE  RASIM  > 

FOR  THE  RASIM  >  26 

TNE  TOTAL  AREA  c 
TNE  MEAN  SORT  VALUE  OVER  TNE  RASIM  * 

FOR  TNE  RASIM  >  27 

TNE  TOTAL  AREA  * 
THE  MEAN  SORT  VALUE  OVER  TNE  RASIN  « 

FOR  TNE  RASIN  »  2t 

THE  TOTAL  AREA  « 
THE  MEAN  SORT  VALUE  OVER  THE  RASIM  > 

FOR  TNE  RASIM  «  29 

TNE  TOTAL  AREA  > 
THE  MEAN  SORT  VALUE  OVER  TME  RASIM  • 

FOR  TNE  RASIN  •  SO 

THE  TOTAL  AREA  > 
THE  MEAN  SORT  VALUE  OVER  THE  RASIN  • 

FOR  TME  RASIM  •  31 

THE  TOTAL  AREA  * 
THE  MEAN  SORT  VALUE  OVER  THE  RASIN  « 

FOR  TIC  RASIN  •  32 

THE  TOTAL  AREA  « 
THE  MEAN  SORT  VALUE  OVER  THE  RASIN  ^ 


0.41S0E«03 

0.2104 


0.4190E*03 

0.2451 


0.2066£*03 

0.1804 


0.W75£*03 

0.3167 


0.2033E^3 

0.2616 


0.1576£*03 

1.0545 


0.47ft4£*03 

0.8160 


0.1817E«03 

0.8430 


0.1820E*03 

0.7439 


0.2450C«03 

0.5979 
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NODAL  POINTS  SEiCCTEO 

NGO  ABSOL  PHASE  NOO  ABSOL  PHASE  BOO  A6SOL  PHASE  NOD  A6SOL  PHASE 


1 

0.26 

U67 

100 

0.19 

0.31 

200 

0.26 

2.07 

300 

0.33 

•1.86 

400 

0.S7 

1.66 

soo 

0.26 

2.73 

600 

0.66 

1.00 

700 

0.73 

0.09 

BOO 

0.63 

■1.02 

900 

0.62 

0.21 

0 

0.00 

0.00 

0 

0.00 

0.00 

COEffiCtENTS 

NO.  ABSOL 

PHASE 

NO. 

ABSOL 

PHASE 

NO. 

ABSOL 

PHASE 

HO. 

ABSOL 

PHASE 

1  O.U 

3.U 

2 

0.43 

*2.91 

3 

0.08 

-2.84 

4 

0.05 

•0.25 

S  0.28 

1.26 

6 

0.27 

0.87 

7 

0.43 

1.4S 

a 

0.27 

2.14 
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WAVE  COHOI1IOM  2 

THE  DEEP  WATER  WAVE  PARAMETERS  fOR  CASE  2  ARE:  NCICHI-  0.000  PERIOD*  11.000  AKCLE^  329.^00 


SOLUTION  OF  THE  SYSTEM 


NOO 

asoi 

PHASE 

NOO 

A8S01 

PHASE 

NdO 

AaSOL 

PHASE 

wb  , 

A8Sa  1 

PHASE 

1 

0.29 

1.62 

2 

0.31 

1.62 

3 

0.32 

1.62 

4 

0.15 

1.62 

5 

0.20 

1.62 

6 

0.25 

1.62 

7 

0.27 

1.53 

8 

0.30 

1.53 

9 

0.32 

1.54 

10 

0.32 

1.54 

11 

0.32 

1.63 

12 

0.08 

1.64 

T3 

0.12 

1  >4 

U 

0.18 

1.53 

15 

0.23 

1.53 

16 

0.25 

t.46 

T7 

0.28 

1.45 

18 

0.30 

1.46 

19 

0.31 

1.46 

20 

0.31 

1.46 

2\ 

0.32 

1.  >5 

22 

0.32 

1.64 

23 

0.30 

1.65 

24 

0.28 

1.66 

25 

0.01 

2.66 

26 

0.05 

1.60 

27 

0.09 

1.48 

28 

0.15 

1.46 

29 

0.21 

1.46 

30 

0.23 

1.38 

31 

0.27 

1,36 

32 

0.29 

1.38 

33 

0.29 

1.29 

34 

0.30 

1.38 

35 

0.30 

1.38 

36 

0.29 

1.39 

37 

0.30 

1.47 

38 

0.30 

1.55 

39 

0.29 

1.57 

40 

0.26 

1.59 

41 

0.26 

1.68 

42 

0.23 

1.65 

43 

0.07 

•1.64 

44 

0.03 

•1.80 

45 

0.02 

1.63 

46 

0.06 

1.42 

47 

0.13 

1.39 

48 

0.18 

1.39 

49 

0.21 

1.31 

50 

0.25 

1.30 

51 

0.28 

1.30 

52 

0.28 

1.21 

53 

0.28 

1.20 

S4 

0.29 

1.29 

55 

0.28 

1.29 

56 

0.27 

1.28 

57 

0.28 

1.40 

58 

0.28 

1.48 

59 

0.26 

1.50 

60 

0.23 

1.52 

61 

0.23 

1.56 

62 

0.19 

1.51 

63 

0.18 

1.60 

64 

0.15 

-1.61 

65 

0.11 

-1.70 

66 

0.06 

-1.78 

67 

0.01 

•2.13 

68 

0.04 

1.37 

69 

0.11 

1.33 

70 

0.17 

1.32 

71 

0.20 

1.24 

72 

0.24 

1.23 

73 

0.26 

1.22 

74 

0.27 

1.13 

75 

0.27 

1.11 

76 

0.26 

1.09 

77 

0.27 

1.19 

78 

0.25 

1.17 

79 

6.23 

1.17 

80 

0.24 

1.30 

81 

0.25 

1.40 

82 

0.22 

1.42 

83 

6.19 

1.43 

84 

0.17 

1.U 

85 

O.U 

1.45 

86 

O.U 

1.55 

87 

6.23 

•1.62 

88 

0.19 

•1.69 

89 

0.13 

-1.75 

90 

0.09 

•1.82 

91 

6.63 

•1.96 

92 

0.02 

1.42 

93 

0.09 

1.28 

94 

0.15 

1.26 

95 

6.16 

1.19 

96 

0.22 

1.17 

97 

0.25 

1.15 

90 

0.26 

1.06 

99 

0.27 

1.63 

160 

6.26 

0.99 

101 

0.24 

0.96 

102 

0.25 

1.07 

103 

6.22 

1.04 

104 

6.18 

1.01 

105 

0.19 

1.17 

106 

0.21 

1.30 

107 

6.17 

1.31 

108 

6.14 

1.33 

109 

0.11 

1.36 

110 

0.09 

1.36 

lit 

0.69 

1.45 

112 

6.30 

•1.63 

113 

0.26 

•1.69 

114 

0.21 

-1.75 

Its 

0.16 

•1.61 

116 

O.U 

•1.87 

117 

0.05 

•1.99 

118 

0.01 

2.07 

119 

6.07 

1.27 

120 

6.13 

1.21 

121 

0.17 

1.15 

122 

0.21 

1.12 

123 

6.24 

1.09 

124 

0.25 

1.01 

125 

0.26 

0.97 

126 

0.26 

0.91 

127 

0.24 

0.66 

128 

0.21 

0.79 

129 

0.21 

0.91 

130 

0.18 

0.64 

131 

O.U 

6.72 

132 

O.U 

0.97 

133 

0.16 

1.17 

134 

0.12 

1.16 

135 

0.09 

1.U 

136 

0.09 

1.23 

137 

0.05 

1.06 

138 

0.06 

1.25 

139 

0.04 

1.11 

140 

0.05 

1.27 

141 

0.37 

•1.64 

142 

0.33 

-1.71 

143 

0.26 

-1.76 

144 

0.23 

-1.81 

145 

0.18 

•1,87 

146 

0.12 

•1.94 

147 

0.06 

•2.09 

148 

0.01 

2.74 

149 

0.06 

1.32 

ISO 

0.12 

1.20 

151 

O.U 

1.U 

152 

0.20 

1.09 

153 

0.24 

1.05 

154 

0.25 

0.97 

155 

0.26 

0.91 

156 

0.26 

0.85 

157 

0.25 

0.71 

158 

0.24 

0.78 

159 

0.22 

0.67 

160 

0.18 

0.52 

161 

0.17 

0.68 

162 

0.13 

0.51 

163 

0.10 

0.16 

164 

0.09 

0.54 

165 

0.10 

0.9Q 

166 

0.06 

0.78 

167 

0.04 

0.50 

168 

0.03 

♦0.75 

169 

0.03 

0.59 

170 

0.03 

0.69 

171 

0.02 

0.73 

172 

0.03 

0.97 

173 

0.42 

•1.66 

174 

0.39 

-1.73 

175 

0.35 

•1.76 

176 

0.30 

•1.82 

177 

0.25 

•1.87 

178 

0.19 

•1,93 

179 

0.13 

-2.01 

180 

0.07 

•2.20 

181 

0.02 

3.14 

182 

0.05 

1.46 

183 

0.11 

1.23 

184 

0.15 

1.17 

185 

0.20 

1.08 

186 

0.23 

1.02 

187 

0.25 

0.95 

188 

0.26 

0.68 

189 

0.26 

0.80 

190 

0.25 

0.67 

191 

0.23 

0.53 

192 

0.22 

0.58 

193 

0.19 

0.41 

194 

0.16 

0.14 

195 

O.U 

0.27 

196 

0.11 

•0.13 

197 

0.10 

•0.68 

198 

0.07 

-0.41 

199 

0.06 

6.13 

200 

0.04 

-0.61 

201 

0.06 

-1.21 

202 

0.05 

-1,18 

203 

0.02 

•0.28 

204 

0.02 

-O.U 

205 

0.02 

0.53 

206 

0.02 

0.64 

207 

0.46 

-l./O 

208 

o.a 

•1.76 

209 

0.40 

•1.80 

210 

0.36 

•1.64 

211 

0.31 

•1.88 

212 

0.25 

-1.93 

213 

0.19 

•2.00 

214 

0.13 

-2.10 

215 

0.08 

-2.33 

216 

0.04 

3.07 

217 

0.05 

1.68 

218 

0.10 

1.31 

219 

0.15 

1.22 

220 

0.19 

1.11 

221 

0.23 

1.02 

222 

0.25 

0.96 

223 

0.26 

6.67 

224 

0.26 

0.78 

225 

0.26 

0.66 

226 

0.25 

0,51 

227 

0.22 

0.31 

228 

0.21 

0.33 

229 

0.18 

0.05 

230 

0.16 

•O.SS 

231 

O.U 

•0.31 

232 

0.14 

-0.79 

233 

0.17 

•1.24 

234 

0,13 

-1.22 

235 

0.08 

-1.06 

236 

0.10 

•1.43 

237 

0.11 

-1.52 

238 

0.05 

-1.19 

239 

0.32 

•2.56 

240 

0.27 

-3.09 

241 

0.27 

2.60 

242 

0.30 

2.50 

243 

0.42 

2.09 

244 

0.57 

1.87 

245 

0.74 

1.75 

246 

0.09 

1,72 

247 

0.96 

1.76 

248 

1.03 

1.99 

249 

1.00 

1.8T 

250 

0.49 

-1.7? 

251 

0.48 

•1.83 

252 

0.46 

-1.84 

253 

0.42 

-1.87 

254 

0.57 

•1.90 

255 

0.31 

-1.94 

256 

0.26 

-1.99 

257 

0.20 

-2.07 

258 

O.U 

-2.21 

259 

0.09 

•2.50 

260 

0.05 

3.07 

261 

0.06 

1.94 

262 

0.10 

1.41 

263 

O.U 

1.51 

264 

0.19 

1.16 

265 

0.22 

1.05 

266 

0.24 

0.99 

267 

0.26 

0.89 

268 

0.27 

0.7V 

269 

0.27 

0.68 

270 

0.26 

0.51 

271 

0.24 

0.31 

272 

0.22 

0.05 

273 

0.20 

0.02 

274 

0.18 

-0.35 

275 

0.19 

-0.75 

276 

0.17 

•0.79 

277 

0.19 

-1.18 

278 

0*24 

•1.48 

279 

0.21 

-1.52 

280 

0.16 

-1.52 

281 

0.19 

-1.70 

282 

0,25 

-1.80 

283 

0.11 

•1.53 

284 

0.41 

•2.12 

285 

0.39 

•2.29 

286 

0.34 

-2.57 

287 

0.27 

-5.01 

288 

0.25 

2.80 

289 

0.31 

2.13 

290 

0.37 

2.10 

291 

0.52 

1.8C 

292 

0.68 

1.66 

293 

0.83 

1.58 

294 

0.92 

1.56 

295 

0.98 

1.58 

296 

1.01 

1.61 

297 

0.52 

•1.90 

298 

0.50 

•1.90 

299 

0.48 

-1.90 

300 

0.45 

1.91 

301 

0.41 

-1.92 

302 

0.36 

•1.95 

303 

0.30 

•2.00 

304 

0.25 

•2.06 

305 

0.19 

•2.16 

306 

0.14 

-2.53 

307 

0.10 

•2.66 

308 

0.07 

3.01 

309 

0.07 

2.14 

310 

0.10 

1.55 

511 

0.14 

1.43 

312 

0.18 

1.23 

313 

0.22 

1.09 

314 

0.24 

1.04 

315 

0.26 

6.93 

316 

0.27 

0.81 

317 

0.28 

0.73 

318 

0.27 

0.56 

319 

0.26 

0.57 

320 

0.24 

0.10 

321 

0.23 

•0.22 

322 

0.21 

-0.29 

323 

0.21 

•0.68 

324 

0.24 

-1.02 

325 

0.22 

•1.10 

326 

0.26 

-1.19 

527 

0.32 

•1.62 

328 

0.29 

-1.69 

329 

0.26 

•1.75 

330 

0.28 

•1.64 

331 

0.36 

-1.95 

332 

0.57 

-1.99 

333 

0.41 

-2.09 

334 

0.42 

-2.18 

335 

0.40 

•2.51 

336 

0.36 

-2.54 

337 

0.29 

•2.89 

538 

0.24 

3.05 

339 

0.24 

2.29 

340 

0.34 

1.74 

341 

0.44 

1.77 

342 

0.60 

1.56 

343 

0.75 

1.44 

3a 

0.86 

1.38 

345 

0.96 

1.37 

346 

1.02 

1.43 

347 

0.46 

•1.10 

346 

0.45 

-1.35 

349 

0.43 

•1.56 

350 

0.43 

-1.73 

351 

0.45 

'1.67 

352 

0.46 

•1.96 

353 

0.48 

•2.03 

354 

0.50 

•2.07 

355 

6.51 

•2.08 

356 

0.52 

•2.01 

357 

0.51 

-2.11 

350 

0.51 

•2.05 

359 

6.49 

-2.61 

360 

0.47 

•1.98 

361 

0.43 

•1.97 

362 

0.39 

•1.97 

S6S 

6.34 

•1.99 

364 

6.29 

•2.05 

365 

0.24 

•2.12 

366 

0.19 

•2.25 

367 

6.U 

•2.46 

SM 

6.11 

•2.80 

369 

0.89 

2.90 

370 

0.08 

2.33 

371 

6.10 

1.77 

372 

6.14 

1.58 

373 

O.M 

1.33 

374 

0.22 

1.17 

373 

0.24 

1.12 

376 

6.26 

0.99 

377 

0.28 

0.06 

370 

0.28 

0.79 

379 

0.26 

0.65 

380 

6.27 

O.U 
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0.2$ 

0.18 

382 

0.24 

•0.13 

383 

0.25  • 

0.48 

3U 

0.25  • 

O.U 

38$ 

0.26 

•0.93 

386 

0.30 

•1.21 

387 

0.28 

•1.30 

368 

0.33  • 

1.34 

389 

0.39 

•1.72 

390 

0.37 

•1.00 

391 

0.33 

■1.87 

392 

0.41  ■ 

2.02 

393 

0.4$ 

•2.16 

394 

O.U 

•2.24 

59$ 

0.42  • 

•2.34 

396 

0.39  • 

2.51 

397 

0.32 

•2.76 

398 

0.23 

•5.02 

399 

0.19 

2.37 

400 

0.26 

1.72 

401 

0.40 

1.31 

402 

0.30 

1.U 

403 

0.67 

1.27 

4U 

0.79 

1.19 

40$ 

0.91 

1.16 

406 

1.00 

1.14 

407 

1.07 

1.19 

408 

0.42 

•1.22 

409 

0.41 

■1.47 

410 

0.40 

-1.67 

411 

0.40 

•1.U 

412 

0.42 

•2.00 

413 

0.43 

•2.12 

414 

0.46 

•2.18 

413 

0.47 

•2.23 

416 

0.49 

•2.24 

417 

0.49 

•2.20 

418 

0.48 

-2.21 

419 

0.47 

•2.22 

420 

O.U 

'2.14 

421 

0.44 

•2.07 

422 

0.41 

-2.03 

423 

0.39 

•2.00 

424 

0.33 

•2.00 

42$ 

0.31 

•2.03 

426 

0.26 

-2.10 

427 

0.22 

-2.20 

428 

0.18 

-2.36 

429 

0.14 

■2.59 

430 

0.12 

•2.91 

431 

0.11 

2.96 

432 

0.10 

2.47 

433 

0.11 

1.97 

434 

O.U 

1.75 

435 

0.18 

1.47 

436 

0.21 

1.27 

437 

0.24 

1.22 

438 

0.26 

1.07 

439 

0.28 

0.94 

440 

0.29 

O.U 

441 

0.29 

0.71 

U2 

0.28 

0.32 

U3 

0.27 

0.28 

4U 

0.26 

0.00 

44$ 

0.26 

•0.34 

446 

0.28 

•0.67 

U7 

0.27 

•0.82 

448 

0.31 

-1.09 

449 

0.36 

•1.33 

430 

0.3S 

-1.43 

431 

0.40 

•1.62 

432 

0.43 

-1.79 

4$3 

0.44 

•1.88 

434 

0.42 

-1.95 

433 

O.U 

•2.09 

436 

0.49 

-2.20 

4$7 

0.46 

•2.28 

438 

O.U 

-2.37 

439 

0.42 

•2.30 

460 

0.33 

-2.U 

461 

0.29 

•2.83 

462 

0.19 

2.99 

463 

0.16 

1.93 

4U 

0.28 

1.21 

46$ 

0.3$ 

0.69 

466 

0.47 

0.91 

U7 

0.57 

1.10 

4U 

0.71 

0.99 

469 

0.86 

0.94 

470 

0.97 

0.90 

471 

1.06 

0.90 

472 

1.U 

0.96 

473 

0.30 

•1.27 

474 

0.29 

•1.57 

473 

0.30 

•1.81 

476 

0.31 

-2.82 

477 

0.34 

•2.20 

478 

0.37 

•2.32 

479 

0.40 

•2.40 

400 

0.42 

•2.45 

481 

0.43 

•2.46 

482 

O.U 

-2.41 

483 

0.43 

-2.43 

4U 

O.U 

‘2.43 

48$ 

0.39 

•2.31 

486 

0.38 

-2.20 

487 

0.35 

•2.10 

488 

0.32 

•2.M 

489 

0.31 

•2.00 

490 

0.29 

-2.00 

491 

0.26 

•2.04 

492 

0.22 

•2.15 

493 

0.19 

-2.30 

494 

0.16 

•2.48 

493 

O.U 

-2.72 

496 

0.13 

•3.01 

497 

0.13 

2.97 

496 

0.12 

2.57 

499 

0.12 

2.13 

SCO 

0.15 

1.92 

$01 

0.18 

1.61 

302 

0.21 

1.39 

303 

0.24 

1.33 

su 

0.26 

1.17 

$0$ 

0.28 

1.02 

306 

0.30 

0.97 

507 

0.30 

0.81 

308 

0.30 

0.62 

$09 

0.29 

0.39 

310 

0.28 

O.U 

311 

0.28 

•0.21 

312 

0.29 

•0.33 

313 

0.32 

•0.84 

314 

0.32 

•0.98 

513 

0.37 

-1.22 

316 

0.42 

•1.41 

$17 

0.41 

-1,52 

318 

0.47 

•1.69 

319 

0.51 

-1.U 

520 

0.30 

-1.93 

$21 

0.48 

-2.01 

322 

0.31 

-2.13 

323 

0.32 

-2.24 

324 

0.49 

•2.32 

$2$ 

0.46 

•2.40 

326 

O.U 

•2-32 

527 

0.38 

•2.61 

328 

0.33 

•2.73 

529 

0.23 

•2.95 

330 

0.11 

2.38 

331 

0.17 

1.12 

532 

0.29 

0.33 

$33 

0.48 

0.42 

334 

0.33 

0.34 

533 

0.62 

0.77 

336 

0.80 

0.71 

537 

0.9$ 

0.66 

338 

1.09 

O.U 

339 

1.17 

0.63 

340 

1.27 

0.70 

$41 

0.08 

•0.83 

342 

0.13 

-1.59 

343 

0.16 

-1.99 

3U 

0.19 

•2.30 

$4$ 

0.24 

-2.52 

346 

0.29 

•2.U 

347 

0.33 

•2.73 

348 

0.36 

•2.78 

$49 

0.37 

-2.78 

330 

0.37 

-2.74 

531 

0.36 

-2.73 

352 

0.33 

•2.76 

553 

0.31 

-2.58 

334 

0.30 

-2.39 

555 

0.27 

•2.23 

356 

0.23 

•2.U 

557 

0.22 

•1.96 

338 

0.21 

•1.91 

339 

0.20 

•1.93 

SU 

0.19 

•2.02 

$61 

0.18 

•2.21 

362 

0.16 

•2.41 

563 

0.13 

-2.61 

3U 

0.13 

•2.83 

$65 

0.14 

•3.05 

366 

0.14 

3.01 

567 

0.13 

2.71 

SU 

0.13 

2.31 

$69 

0.1$ 

2.10 

570 

0.18 

1.78 

571 

0.21 

1.32 

572 

0.24 

1.45 

$73 

0.26 

1.28 

574 

0.26 

1.13 

575 

0.30 

1.10 

376 

0.31 

0.93 

577 

0.31 

0.76 

378 

0.30 

0.34 

579 

0.29 

0.28 

380 

0.29 

•0.02 

$81 

0.30 

-0.3$ 

382 

O.SS 

•O.U 

383 

0.37 

•0.93 

3U 

0.37 

•1.09 

$8$ 

0.42 

•1,30 

386 

0.48 

•1.48 

387 

0.48 

•1.59 

SU 

0.32 

•1.75 

$89 

0.56 

•1.88 

390 

0.34 

-1.97 

591 

0.32 

•2.03 

392 

0.34 

•2.17 

$93 

0.54 

•2,29 

394 

0.31 

•2.37 

393 

0.48 

-2.U 

396 

0.43 

•2.55 

$97 

0.40 

•2.62 

396 

0.36 

•2.72 

399 

0.27 

•2.62 

600 

0.13 

•5.12 

601 

0.09 

1.10 

602 

0.21 

0.31 

603 

0.42 

0.26 

604 

O.U 

0.22 

60$ 

0,73 

0.46 

606 

0.91 

0.42 

607 

1.09 

0.40 

6U 

1.24 

0.39 

609 

1.4$ 

0.4$ 

610 

0.12 

0.8$ 

611 

0.03 

0.61 

612 

0.02 

2.96 

613 

0.08 

•3,14 

614 

0.18 

3.U 

613 

0.24 

3.03 

616 

0.29 

3.02 

617 

0.32 

3.02 

618 

0.34 

3.U 

619 

0.33 

3.09 

620 

0.32 

3.U 

621 

0.28 

3.0$ 

622 

0.23 

•3.00 

623 

0.21 

-2.73 

624 

0.18 

-2.49 

625 

0.15 

•2.18 

626 

0.12 

•1.8$ 

627 

0.10 

-1.51 

628 

0.11 

•1.31 

629 

0.11 

•1.66 

630 

0.11 

•1.93 

631 

0.13 

•2.28 

632 

O.U 

•2.54 

633 

0.1$ 

•2.73 

634 

0.13 

•2.89 

633 

0.15 

-3.03 

636 

0.16 

3.U 

637 

0.1$ 

2.81 

636 

0.14 

2.48 

639 

0.16 

2.30 

6U 

0.18 

1.96 

641 

0.20 

1,67 

642 

0.23 

1.62 

U5 

0.26 

1.42 

6U 

0.29 

1.26 

64$ 

0.31 

1.26 

646 

0.32 

1.10 

U7 

0.32 

0.92 

6U 

0.32 

0.71 

649 

0,31 

0.48 

650 

0.30 

0.19 

631 

0.31 

•O.U 

452 

0.34 

•0.45 

653 

0.38 

•0.74 

634 

0.43 

•0.98 

633 

0.43 

•1.U 

«$6 

8.49 

-1.35 

657 

0.34 

•1.31 

636 

0.34 

-1.U 

659 

0.37 

•1.78 

UO 

8.U 

-1.91 

661 

0.38 

•2.00 

662 

0.36 

-2.09 

663 

0.37 

*2.22 

6U 

0.36 

•2.33 

663 

0.33 

•2.43 

666 

0.49 

-2.49 

U7 

0.47 

•2.62 

6U 

0.42 

•2.67 

669 

0.38 

-2.77 

670 

0.31 

-2.79 

671 

0.21 

•2.83 
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8.03 

•3.07 
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609  0.33  2.47  690  0.3$  2.31  691  0.36  2.34  692  O.SS  2.30 


693 

0.33 

2.38 

694 

0.30 

2.34 

493 

0.23 

2.71 

6U 

8.17 

2.18 

697 

0.11 

3.13 

698 

0.03 

-2.69 

699 

0.03 

'0.81 

780 

0.08 

•0.16 

701 

0.11 

0.02 

702 

0.10 

-0.10 

703 

O.U 

-O.U 

7U 

0.03 

-1.42 

705 

0.08 

-2.37 

706 

0.12 

-2.63 

707 

0.15 

-2.80 

788 

0.16 

•2.91 

709 

0.17 

•3.01 

710 

0.17 

•3.12 

711 

0.16 

2.93 
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2.U 

713 

0.17 

2.30 

7U 

0.18 

2.17 

713 

0.21 

1.87 

716 

0.23 

1.83 

717 

0.26 

1.61 

718 

0.29 

1.43 

719 

0.31 

1.45 

720 

0.32 

1.26 

721 

0.33 

1.09 

722 

0.33 

0.89 

725 

0.32 

O.U 

724 

0.31 

0.41 

725 

0.31 

0.09 

726 

0.33 

-0.22 

727 

0.37 

-0.33 

728 

0.42 

•0.78 

729 

O.U 

•1.00 

730 

0.49 

-1.17 

751 

0.36 

-1.33 

732 

0.61 

•1.50 

733 

0.39 

-1.63 

734 

0.63 

•1.80 

735 

O.U 

-1.93 

736 

0.61 

•2.U 

737 

0.39 

•2,13 

738 

0.39 

•2.27 

739 

0.37 

•2.42 

7U 

0.54 

-2.50 

741 

0.31 

•2.37 

742 

0.47 

•2.71 

743 

0.43 

•2.75 

7U 

0.39 

•2.U 

745 

0.33 

•2.83 

7U 

0.26 

'2.82 

747 

0.13 

•2.67 

7U 

0.10 

-1.91 

749 

0.22 

'0.32 

730 

O.U 

'0.33 

731 

0.70 

•0.30 

732 

O.U 

•0.28 

753 

1.02 

-0.03 

734 

1.24 

'O.U 

753 

1.U 

•O.U 

736 

1.U 

•0.03 

757 

1.79 

0.03 

738 

0.38 

0.73 

739 

0.32 

O.U 

7U 

0.23 

O.U 

761 

0.22 

1.26 

762 

0.23 

1.63 

763 

0.29 

1.09 

7U 

0.35 

2.02 

763 

O.U 

2.11 

7U 

0.43 

2.15 

767 

O.U 

2.19 

7U 

0.42 

2.21 

7U 

O.U 

2.19 

770 

8.33 

2.17 

m 

0.28 

2.25 

772 

0.19 

2.29 

773 

0.12 

2.20 

m 

0.07 

1.U 

775 

0.09 

0.74 

776 

0.13 

O.U 

777 

0.21 

0.42 

778 

8.23 

O.U 

779 

0.21 

0.41 

710 

0.13 

0.36 

781 

8.04 

0.16 

782 

8.03 

•2.36 

713 

0.11 

•2.73 

7U 

0.13 

-2.81 

783 

8.17 

•2.89 
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0.18 

•2.95 
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0.19 

•3.01 

7M 

0.18 

3.07 
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8.17 

2.82 
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799 

1.08 

1.57 
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1.02 

1.21 
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807 
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•0.46 

808 

0.54 
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809 
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•1.34 

810 

0.65 

1.48 
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812 
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1.78 

813 
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-1.92 

8U 
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-2.07 
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0.61 

2.18 

816 

0.60 

•2  33 

817 

0.58 

-2.51 
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0.55 

•2.59 

819 

0.51 

-2.66 

820 

0.48 

•2.85 
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O.U 

•2.66 
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0.40 

•3.00 

823 

0.35 

-2.96 

824 

0.28 

-2.88 

62S 
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-2.73 

826 

0.17 

2.47 

827 

0.15 

-1.50 

828 

0.36 

-0.69 

829 

0.60 

-0.54 

830 

0.85 

-0.50 

831 

1.10 

-0.49 

832 

1.18 

-0.28 

833 

1.43 

'0.26 

834 

1.67 

-0.26 

835 

1.93 

-0.14 

836 

0.48 

0.38 

857 

0.40 

0.35 

838 

0.31 

0.55 

839 

0.26 

0.97 

840 

0.29 

1.39 

841 

0.35 

1.64 

842 

0.42 

1.80 

843 

0.48 

1.88 

844 

0.52 

1.92 

84S 

0.53 

1.95 

846 

0.51 

1.97 

847 

0.47 

1.95 

848 

0.41 

1.95 

849 

0.33 

1.97 

850 

0.24 

1.94 

851 

0.17 

1.78 
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0.14 

1.36 

8S3 

0.16 

0.86 

8S4 

0.22 

0.62 

855 

0.29 

0.54 

856 

0.36 

0.52 
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0.40 

0.54 

858 

0.35 

0.55 
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0.20 

0.57 

860 

0.08 

0.60 
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0.04 

•2.79 

862 

0.10 

•2.73 

863 

0.15 

-2.76 
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0.18 

•2.80 
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0.19 

-2.84 
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0.20 

•2.87 

867 

0.19 

•3.04 

868 

0.19 

3.02 

869 

0.19 

2.95 

870 

0.19 

2.65 
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0.20 

2,54 
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0.87 

2.U 
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2.56 

874 
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2.30 
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1.96 
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1.01 

1.79 
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1.63 
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1.47 
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1.30 
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1.01 

1.11 
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862 
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0.65 
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0.41 

864 
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O.U 
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1.01 

'0.10 
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1.12 

•0.36 
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1.23 

•0.59 

886 

1.33 

'0.68 

889 

1.40 

-0.88 
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1.43 

-1.07 
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0.68 

•1.61 

892 

0.69 

-1.75 

893 

0.70 

-1.66 

894 

0.68 

•2.06 
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0.64 

•2.22 

896 

0.62 

•2.40 

897 

0.59 

-2.60 

898 

0.55 

'2.72 

099 

0.52 

-2.80 

900 

0.49 

-3.01 

901 

0.45 

-3.02 

902 

0.42 

3.09 

903 

0.37 

•3.13 

904 

0.31 

•3.02 

905 

0.24 

-2.84 

906 

0.19 

•2.54 

907 

0.16 

-1.86 

906 

0.33 

-1.06 

909 

0.58 

-0.82 

910 

0.85 

-o.n 

911 

1.11 

-0.70 

912 

1.34 

-0.48 

913 

1.61 

-0.47 

914 

1.83 

•0.64 

915 

2.03 

-0.32 

916 

0.58 

-0.01 

917 

0.48 

-0.08 

918 

0.3S 

0.13 

919 

0.26 

0.59 

920 

0.29 

1.18 

921 

0.37 

1.49 

922 

0.47 

1.65 

923 

0.55 

1.73 

924 

0.59 

1.77 

925 

0.60 

1.79 

926 

0.56 

1.80 

927 

0.52 

1.79 

928 

0.45 

1.77 

929 

0.36 

1.78 

930 

0.27 

1.74 

931 

0.20 

1.60 

932 

0.17 

1.31 

933 

0.19 

0.90 

934 

0.26 

0.66 

935 

0.34 

0.58 

936 

0.42 

0.55 

937 

0.50 

0.55 

938 

0.55 

0.57 

939 

0.49 

0.62 

940 

0.24 

0.68 

941 

0.09 

0.76 

942 

0.03 

•2.90 

943 

0.11 

-2 .65 

9U 

0.16 

-2.U 

945 

0.18 

-2.69 

946 

0.20 

•2.73 

947 

0.20 

-2.74 

948 

0.20 

-2.87 

949 

0.19 

-3.07 

950 

1.13 

■2.74 

951 

1.02 

•2.94 

952 

0.93 

3.12 

953 

0.85 

2.74 

954 

0.84 

2.U 

955 

0.67 

2.18 

956 

0.09 

1.85 

957 

0.95 

1.68 

958 

0.99 

1.52 

959 

1.00 

1.37 

960 

0.99 

1.21 

961 

0.95 

1.03 

962 

0.90 

0.80 

965 

0.67 

0.56 

964 

0.67 

0.30 

965 

0.90 

0.02 

966 

0.97 

-0.24 

967 

1.09 

-0.50 

968 

1.22 

•0.72 

969 

1.33 

•0.84 

970 

1.40 

-1.01 

971 

1.42 

-1.20 

972 

1.42 

•1.29 

973 

1.32 

-1.61 

974 

1.26 

•1.82 

975 

0.66 

-2.06 

976 

0.66 

•2.23 

977 

0.63 

•2.45 

978 

0.60 

•2.74 

979 

0.60 

•5.12 

960 

0.56 

'2.88 

981 

0.52 

-2.97 

962 

0.51 

3.06 

983 

0.47 

3.06 

964 

0.43 

2-92 

985 

0.57 

2.99 

906 

0.31 

3.13 

967 

0.25 

-2.94 

968 

0.21 

-2.61 

989 

0.21 

2.03 

990 

0.31 

•1.43 

991 

0.55 

•1.08 

992 

0.63 

-0.95 

993 

1.11 

-0.90 

994 

1.38 

'0.72 

995 

1.64 

•0.68 

996 

1.86 

'0.63 

997 

2.08 

-0.49 

998 

0,72 

•0,54 

999 

0.59 

•0.42 

1000 

0.43 

•0.36 

1001 

0.27 

'0.03 

1002 

0.22 

0.51 

1003 

0.26 

1.07 

1004 

0.37 

1.U 

1005 

0.49 

1.59 

1006 

0.58 

1.66 

1007 

0.63 

1.69 

1006 

O.U 

1.70 

1009 

0.61 

1.71 

1010 

0.54 

1,70 

toil 

0.45 

1.68 

1012 

0.55 

1.69 

1013 

0.26 

1.64 

1014 

0.19 

1.47 

1015 

0.17 

1.12 

1016 

0.19 

0.79 

1017 

0.27 

0.62 

1018 

0.33 

0.58 

1019 

0.41 

0.56 

1020 

0.51 

0.55 

1021 

0.62 

0.56 

1022 

0,72 

0.56 

1023 

0.62 

0.57 

1024 

0.99 

0.49 

1025 

0.98 

0.35 

1026 

0.06 

0.08 

1027 

0.75 

•0.30 

1028 

0.72 

-0.81 

1029 

0.80 

-1,53 

1030 

0.94 

'1,70 

1031 

1.26 

•2.45 

1032 

1.22 

•2.58 

1033 

1,11 

-2.82 

1034 

1.00 

-3.03 

1035 

0.90 

3.00 

1036 

0.78 

2.62 

1037 

0.76 

2.29 

1038 

0.79 

2.01 

1059 

0.61 

1.71 

1040 

0.66 

1.53 

1041 

0.90 

1.39 

1042 

0.91 

1.26 

1043 

0,09 

1.11 

10U 

O.U 

0.94 

1045 

0.79 

0.72 

1046 

0.76 

0,47 

1047 

0.76 

0.18 

1046 

0.01 

•0.12 

1049 

0.90 

•0.40 

1050 

1.03 

-0.64 

1051 

1.16 

-0.85 

1052 

1.29 

-0.99 

1053 

1.37 

-1,16 

1054 

1,39 

'1.32 

1055 

1.39 

-1.45 

1056 

1.33 

•1.67 

1057 

1.26 

•1,92 

1058 

1.20 

2.15 

1059 

0.65 

2.26 

1060 

0.62 

2.52 

1061 

0.60 

•2,91 

1062 

0.63 

2.96 

1063 

0.55 

3.09 

1064 

0.53 

2.U 

1065 

0.49 

2.81 

1066 

0.45 

2.71 

1067 

0.39 

2.80 

1066 

0.32 

2.94 

1069 

0.26 

•3,11 

1070 

0.22 

'Z,n 

1071 

0.23 

2.19 

1072 

0.32 

1.69 

1073 

0.51 

-1,37 

1074 

0.80 

•1.18 

1075 

1,07 

-i.n 

1076 

1.37 

'0.96 

1077 

1.63 

-0.90 

1078 

1.90 

'0.83 

107V 

2.06 

-0.68 

1060 

0.90 

-0.60 

1081 

0.76 

-0,74 

1082 

0.56 

'0.79 

1083 

0.56 

•0.65 

1084 

0.19 

•0.09 

1085 

0.21 

1.02 

1086 

0.55 

1.42 

1087 

0.49 

1,55 

1066 

0.60 

1.59 

1089 

0.66 

1.61 

1090 

0.66 

1.62 

1091 

6.62 

1.61 

>092 

0.55 

1.60 

1093 

0.43 

1.60 

1094 

0.32 

1.57 

1095 

0.22 

1.49 

1096 

0.14 

1.27 

1097 

0.13 

0.90 

1098 

0.16 

0,58 

1099 

0.24 

0.51 

1100 

0.34 

0.52 

1101 

0.47 

0,55 

1102 

0.60 

0.56 

1103 

0.72 

0.55 

1104 

0.82 

0.54 

1105 

0.94 

0.49 

1106 

1.00 

0.38 

1107 

0.95 

0.21 

1108 

0.85 

'0.03 

1109 

0.74 

-0.41 

1110 

0.71 

-0.96 

1111 

0.61 

-1.45 

1112 

0.97 

•1.8? 

1113 

1.13 

2.03 

1114 

1.25 

'2,29 

1115 

1.26 

•2.54 

1116 

1.20 

'2.71 

1117 

1.07 

2.92 

1118 

0.92 

3.12 

1119 

0.76 

2.83 

1120 

0.68 

2.45 

1121 

0.64 

2.07 

1122 

0.66 

1.74 

1123 

0.71 

1.50 

1124 

0.75 

1.52 

1125 

0.77 

1.20 

1126 

0.76 

1,09 

1127 

0.73 

0.97 

1128 

0.69 

O.U 

1129 

0.63 

0.64 

1130 

0.60 

0.58 

1131 

0.61 

0.06 

1132 

O.U 

0.29 

1133 

0.79 

'0.56 

1134 

0.94 

'0.79 

1135 

1.09 

•0.98 

1136 

1.22 

'1.14 

1137 

1.31 

'1.29 

1138 

1.34 

-1,U 

1139 

1.34 

•1.62 

1140 

1.30 

-1.81 

1141 

1.24 

-2.03 

1142 

1.19 

-2.29 

1143 

1.17 

2.56 

11U 

1.21 

•2.93 

1145 

1.27 

2.99 

1146 

0.64 

5.02 

1147 

0.76 

2.68 

»48 

0.74 

2.47 

1149 

0.63 

2.71 

1150 

0.58 

2.60 

1151 

0.53 

2.56 

1152 

0.47 

2.56 

1153 

0.40 

2.62 

1154 

0.33 

2.74 

1155 

0.26 

3.00 

1156 

0.23 

-2.87 

1157 

0.25 

'2.34 

1156 

0.33 

-1.97 

1159 

0.49 

•1.66 

1160 

0.76 

•1.45 

1161 

1.05 

•1.34 

1162 

1.33 

•1.27 

1165 

1.60 

•1.20 

11U 

1.89 

•1,10 

1165 

2.08 

-0.91 

1166 

1.17 

•0,95 

1167 

1.03 

•1.11 

1168 

0.76 

'1.15 

1169 

0.49 

'1.16 

1170 

0.20 

•0.96 

1171 

0.10 

0.90 

1172 

0.30 

1.49 

iin 

0.48 

1.56 

1174 

0.60 

1.57 

1175 

0.66 

1.55 

1176 

O.U 

1.55 

1177 

0.59 

1.30 

1178 

0.49 

1.47 

1179 

0.35 

1.42 

1180 

0.22 

1.33 

1181 

0.10 

1.02 

1182 

0.06 

0.15 

1183 

0.08 

-0.41 

1184 

0.11 

•0.24 

1185 

0.18 

0.16 

1186 

0.29 

0.42 

1167 

O.U 

0.53 

1188 

0.61 

0.57 

1189 

0.78 

0.56 

1190 

0.90 

0.52 

1191 

0.99 

0.45 

1192 

1.02 

0.33 

1193 

0.96 

0.16 

1194 

0.84 

-0.10 

1195 

0.73 

•0.52 

1196 

0.71 

-1.08 

1197 

0.82 

•1.57 

1190 

1.01 

-t.fl 

1199 

1.15 

-2.16 

1200 

1.26 

•2.38 

1201 

1.26 

-2.60 

>202 

1.17 

•2.79 

1203 

1.02 

2.99 

1204 

0.82 

3.04 

1205 

0.64 

2.69 

1206 

0.52 

2.21 

1207 

0.51 

1.70 

1208 

0.55 

1.33 

1209 

0.60 

1.10 

1210 

0.61 

0.95 

1211 

0.60 

0.85 

1212 

0.56 

0,79 
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NODAL  K)IHTS 


NOD 

AfiSOL 

7NA$C 

NOD 

ADSOL 

msc 

NOD 

AtSOL 

7NASC 

NOD 

A8S0L 

PHASE 

1213 

0.51 

0.75 

1214 

0.46 

0.67 

1215 

0.39 

0.51 

1216 

0.36 

0.23 

1217 

0.38 

•0.18 

1218 

0.46 

-0.55 

1219 

0.61 

-0.82 

1220 

0.78 

-1.02 

1221 

0.94 

-1.17 

1222 

1.10 

•1.32 

1223 

1.20 

-1-47 

1224 

1.24 

-1.64 

122S 

1.25 

•1.8L 

1226 

1.23 

•2.05 

1227 

1.20 

-2.32 

1228 

1.19 

•2.59 

1229 

1.21 

-2.90 

1230 

1.25 

3.05 

1231 

1.30 

2.73 

1232 

1.24 

2.50 

1233 

0.99 

2.42 

1234 

0.90 

2.27 

1235 

0.73 

2.29 

1236 

0.65 

2.28 

1237 

0.54 

2.30 

1238 

0.45 

2.35 

1239 

0.36 

2.47 

1240 

0.28 

2.73 

1241 

0.23 

-3.08 

1242 

0.26 

•2.56 

1243 

0.36 

•2-21 

12U 

0.50 

-1.99 

1245 

0.71 

•1.81 

1246 

1.01 

-1.69 

1247 

1.28 

-1.63 

1248 

1.55 

•1.58 

1249 

1.82 

-1.50 

1250 

2.0Q 

•1.29 

1251 

1.56 

•1.25 

1252 

1.29 

•1.41 

1253 

0.99 

•1.44 

1254 

0.65 

-1.48 

1255 

0.29 

-1.52 

1256 

0.01 

-2.73 

1257 

0.26 

1.67 

1258 

0.45 

1.61 

1259 

0.59 

1.56 

1260 

0.65 

1.51 

1261 

0.63 

1.45 

1262 

0.55 

1.39 

1263 

0.42 

1.29 

1264 

0.26 

1.12 

1265 

0.11 

0.55 

1266 

0.11 

‘0.90 

1267 

0.19 

-1.SS 

1260 

0.21 

•1.U 

1269 

0.19 

•1.37 

1270 

0.13 

-0.90 

1271 

0.17 

0.18 

1272 

0.34 

0.56 

1273 

0.55 

0.63 

1274 

0.74 

0.62 

1275 

0.90 

0.56 

1276 

1.00 

0.47 

1277 

1.02 

0.34 

1278 

0.95 

0.1S 

1279 

0.82 

•0.15 

1280 

0.70 

•0.60 

1281 

0.70 

‘1.18 

1282 

0.84 

•1.67 

1283 

1.03 

•2.02 

1284 

1.10 

-2.27 

1285 

1.27 

•2.48 

1286 

1.25 

-2.69 

1287 

1.12 

•2.09 

1288 

0.92 

•5.13 

1289 

0.69 

2.85 

1290 

0.50 

2-35 

1291 

0.43 

1.60 

1292 

0.49 

1.00 

1293 

0.57 

0.74 

1294 

0.60 

0.54 

1295 

0.59 

0.37 

1296 

0.52 

0.29 

1297 

0.41 

0.20 

1298 

0.30 

0.21 

1299 

0.20 

0.25 

1300 

0.12 

0.20 

1301 

0.08 

-0.32 

1302 

0.13 

-0.99 

1303 

0.24 

•1.15 

1304 

0.40 

•1.23 

1305 

0.58 

•1.29 

1306 

0.75 

-1.40 

1307 

0.92 

-1.49 

1308 

1.04 

•1.65 

1309 

1.11 

-1.82 

1310 

1.13 

•2.03 

1311 

1.13 

•2.20 

1312 

1.15 

•2.58 

1313 

1.19 

-2.90 

1314 

1.28 

3.05 

1315 

1.38 

2.00 

1316 

1.40 

2.53 

1317 

1.23 

2.28 

1318 

1.02 

2.13 

1319 

0.86 

2.00 

1320 

0.75 

2.05 

1321 

0.63 

2.05 

1322 

0.51 

2.08 

1323 

0.39 

2.19 

1324 

0.29 

2.46 

1325 

0.23 

2.94 

1326 

0.26 

•2-75 

1327 

0.37 

•2.40 

1328 

0.50 

•2.25 

1329 

0.71 

-2.15 

1330 

0.99 

-2.05 

1331 

1.27 

•2.01 

1332 

1.51 

-2.01 

1333 

1.74 

•2.01 

1334 

1.87 

•1.87 

8 

0.00 

0.00 

0 

0.00 

0.00 
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POe  THE  BASIN  «  1 

THE  TOTAL  AltEA  s 
THE  MEAN  SORT  VALUE  OVEt  TNC  BASIN  * 

POft  THE  BASIN  «  2 

THE  TOTAL  AREA  » 
THE  MEAN  SOAT  VALUE  OV£«  THE  BASIN  « 

fO*  TNC  BASIN  >  S 

TNC  total  ABEA  > 
THE  MEAN  SORT  VALUE  OVEt  T»«  BASIN  « 

fOft  THE  BASIN  ■  A 

THE  total  area  > 
THE  MEAN  SORT  VALUE  OVE*  THE  BASIN  « 

TOR  THE  BASIN  >  S 

Titf  TOTAL  AREA  * 
TNC  MEAN  SORT  VALUE  OVER  TMC  BASIN  « 

FOR  TMC  BASIN  ■  B 

Titf  TOTAL  AREA  « 
TIS  MEAN  SORT  VALUE  OVER  TNE  BASIN  • 

FOR  TNC  BASIN  -  7 

TNE  total  area  > 
TNC  MEAN  SORT  VALUE  OVER  TNC  BASIN  > 

FOR  TMC  BASIN  «  B 

TMC  total  AREA  • 
TMC  MEAN  SORT  VALUE  ONU  TMC  BASIN  • 

FOR  TME  BASIN  •  9 

THE  TOTAL  AREA  • 
TNC  MEAN  SORT  VALUE  CMER  THE  BASIN  « 

FOR  TIC  BASIN  •  10 

TNC  total  area  * 
TNE  MEAN  SORT  VALUE  OVER  TNE  BASIN  • 

FOR  TNC  US1N  «  11 

TNE  total  area  ■ 
THE  MEAN  SORT  VALUE  OVER  THE  BASIN  » 

FOR  TNC  basin  «  12 

TNE  TOTAL  AREA  * 
THE  MEAN  SORT  VALUE  OVER  THE  BASIN  ■ 

FOR  TNE  BASIN  •  13 

TNE  total  area  • 
TNC  MEAN  SORT  VALUE  OVER  TNE  BASIN  « 

FOR  TNC  BASIN  «  1« 

THE  total  area  * 
TNE  MEAN  SORT  VALUE  OVER  THE  BASIN  « 

FOR  TNC  BASIN  •  13 

TNC  total  area  « 
TNC  MEAN  SQNT  VALUE  OVER  TMC  BASIN  « 

FOR  THE  BASIN  «  TO 

TNC  total  area  > 

TNC  MEAN  SORT  VALUE  OVER  THE  BASIN  > 

FOR  TNC  BASIN  •  17 

TNC  TOTM.  AREA  « 
INC  MEAN  SORT  VALUE  OVER  TNC  BASIN  « 

FOR  TNC  BASIN  •  18 

TNC  total  area  * 
TNE  MEAN  SORT  VALUE  OVER  TNE  BASIN  « 

FOR  TNE  BASIN  »  19 

TME  total  area  > 
TNC  MEAN  SORT  VALUE  OVER  TMC  BASIN  > 

FOR  TME  BASIN  •  20 

TNC  total  area  • 
TNI  MEAN  SORT  VALUE  Wf9  TME  BASIN  « 

FOR  TMC  BASIN  •  21 

TME  TOTAL  ARCA  > 
TNC  ICAH  BORT  VALUE  OVER  IRC  BASIN  • 

FOR  TNI  BASIN  •  22 

TNE  total  AREA  < 
TRE  fCAM  SORT  VALUE  OVER  TMC  BASIN  • 
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0.2t21£*03 

0.5660 


O.L73V£*OJ 

0.5060 


0.4349E«03 

0.4M0 


0.«L97E«03 

0.3645 


0.2069C«03 

0.2336 


0.2091E«03 

0.2602 


0.1908E*0S 

0.2767 


0.1BB7E«03 

0.2004 


0.2057EHD 

0.134B 


0.2317E«OS 

0.1336 


0.4a23E«03 

0.1341 


0.4129E«03 

0.1206 


0.4010EH)3 

0.2499 


0.4440E«03 

0.2222 


O.U63E«03 

0.1760 


O.U09E*03 

0.1323 


0.4T73€*03 

0.2323 


0.4Qe3C«03 

0.2249 


0.4U2E*03 

0.0378 


0.3045C«03 

0.2371 


0.4S21C«03 

0.3m<7 


0.4066C«03 

0.0764 


FOR  fNC  tASlM  >  23 


INC  NCMI  SORT  VALUE 


TNC  TOTAL  AREA 
OMR  INC  lASIN 


FOR  TtC  tASIH  ■  24 

THE  TOTAL  AREA 
THE  MEAN  SORT  VALUE  OVER  THE  RAStH 


FOR  THE  lASIH  ■  2S 

THE  TOTAL  AREA 
THE  ICAH  SORT  VALUE  OVER  THE  RASIM 


FOR  THE  RASIH  «  26 

the  total  area 

THE  HEAR  SORT  VALUE  OVER  THE  RASIH 


FOR  THE  RAStH  •  27 

THE  TOTAL  AREA 
THE  MEAN  SORT  VALUE  OVER  THE  RASIH 


FOR  THE  RASIH  •  28 

THE  TOTAL  AREA 
THE  NEAR  SORT  VALUE  OVER  THE  RASIH 


FOR  THE  RASIH  •  79 

THE  TOTAL  AREA 
the  MEAM  SORT  VALUE  OVER  THE  RASIH 

FOR  THE  RASIH  «  SO 

THE  TOTAL  AREA 
THE  HEAH  SORT  VALUE  OVER  THE  RASIH 


FOR  THE  RASIH  •  31 

THE  TOTAL  AREA 
THE  MEAH  SORT  VALUE  OVER  THE  RASIH 


FOR  THE  RASIH  •  32 

THE  TOTAL  AREA 
THE  ICAH  SORT  VALUE  OVER  THE  RAStH 


0.41S0E«O3 

o.2ioe 


O.41«0E«O3 

0.3033 


0.2066E«03 

0.2S0S 


0.1973E«03 

o.ns3 


0.20SSE*03 

0.03RR 


0.1S76E«C3 

0.S461 


0.4784E«a5 

0.3737 


e.1Rl7E*05 

0.4378 


0.1828E»03 

0.335S 


0.2450E*03 

0.1U1 
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NODAL  POINIS  S€L£CT£0 

NOD  ASSOL  PHASE  NGO  ASSOL  PHASE  NOD  ASSOL  PHASE  MOO  ABSOL  PHASE 


1 

0.?9 

1.62 

100 

0.26 

0.99 

200 

0.04 

•0.61 

300 

0.45 

-1.91 

400 

0.26 

1.72 

soo 

0.15 

1.92 

600 

0.13 

•3.12 

700 

0.08 

-0. 16 

800 

1.07 

1.41 

000 

0.49 

-3.01 

0 

0.00 

0.00 

0 

0.00 

0.00 

COCFEICIENTS 

NO. 

ABSOL 

PHASE 

NO. 

ABSOL 

PHASE 

MO. 

A8SOL 

PHASE 

MO. 

ABSOL 

PHASE 

1 

0.17 

•0.63 

2 

0.37 

-0.23 

3 

0.14 

'0.36 

4 

0.05 

2.51 

5 

0.33 

•2.51 

6 

0.36 

•2-36 

7 

0.56 

•1.57 

6 

0.43 

•0.37 
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APPENDIX  9-E:  INPUT  DATA  SET  FOR 
MAALAEA  HARBOR,  MAUI,  HAWAII  EXAMPLE 
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GENSPECS  ENGLISH  HARBD  MAALAEA  HARBOR,  MAUI,  HI  -  EXISTING  CONFIGURATION 


GRIDSPEC 

TRIANG 

ENGLISH 

3752 

7146 

105 

252 

107 

MAALAEA. INP 

CONVERG 

0.1 

WAVCOND 

0.00 

20.0 

265.0 

PRWINDOW 

NO 

NONE 

NO 

16 

PRBASIN 

7 

PRBNELEM 

2978 

2987 

2976 

3063 

3018 

3011 

2969 

PRBASIN 

6 

PRBNELEM 

2250 

2235 

2230 

2116 

2097 

2115 

PRBASIN 

6 

PRBNELEM 

1249 

1277 

1231 

1142 

1113 

1167 

PRBASIN 

6 

PRBNELEM 

2653 

2617 

2533 

2570 

2584 

2691 

PRBASIN 

6 

PRBNELEM 

1750 

1817 

1657 

1661 

1720 

1818 

PRBASIN 

6 

PRBNELEM 

85 

93 

125 

138 

130 

102 

PRBASIN 

7 

PRBNELEM 

154 

169 

159 

216 

235 

210 

163 

PRBASIN 

6 

PRBNELEM 

200 

206 

270 

248 

242 

182 

PRBASIN 

6 

PRBNELEM 

359 

337 

355 

387 

428 

402 

PRBASIN 

7 

PRBNELEM 

488 

509 

565 

603 

574 

510 

488 

PRBASIN 

7 

PRBNELEM 

911 

939 

1009 

1045 

1012 

931 

900 

PRBASIN 

7 

PRBNELEM 

1431 

1304 

1271 

1302 

1392 

1440 

1467 

PRBASIN 

6 

PRBNELEM 

2611 

2627 

2621 

2484 

2460 

2476 

PRBASIN 

6 

PRBNELEM 

2733 

2727 

2622 

2600 

2618 

2720 

PRBASIN 

6 

PRBNELEM 

2803 

2793 

2677 

2654 

2673 

2790 

PRBASIN 

6 

PRBNELEM 

2765 

2782 

2766 

2685 

2656 

2693 

GRIDFORM 

(3(I6,2F10.2))(2(4I6,F8 

.2.F8.4)) 

(5(215, F5. 2)) 

1 

1082.90 

-309.69 

2 

1070.74 

-317.02 

3 

1082.32 

-328.53 

4 

1063.82 

-306.45 

5 

1053.89 

-315.08 

6 

1062.70 

-327.94 

7 

1046.16 

-304.22 

8 

1034.33 

-313.79 

9 

1044.01 

-326.80 

10 

1026.43 

-301.99 

11 

1015.36 

-310.66 

12 

1021.45 

-325.43 

13 

1004.71 

-297,53 

14 

1002.43 

-309.59 

15 

1002.98 

-324.27 

16 

997.76 

-339.47 

17 

991.39 

-357.09 

18 

1022.64 

-113.44 

19 

1019.04 

-145.87 

20 

1016.84 

-168.01 

21 

1014.43 

-192.20 

22 

1011.82 

-218.45 

23 

1009.22 

-244.60 

24 

1006.91 

-267.83 

25 

1004.87 

-288.29 

26 

990.89 

-294.67 

27 

988.89 

-306.04 

28 

986.79 

-320.25 

29 

981.97 

-335.10 

30 

974.62 

-355.36 

31 

1005.27 

-112.07 

32 

1002.98 

-142.54 

33 

999.89 

-165.48 

34 

996.79 

-189.33 

35 

992.86 

-213.77 

36 

989.20 

-237.92 

37 

985.54 

-261.46 

38 

982.17 

-281.39 

39 

974.29 

-306.14 

40 

967.13 

-330.68 

41 

958.38 

-353.44 

42 

991.48 

-110.98 

43 

987.51 

-143.14 

44 

984.14 

-166.69 

45 

980.20 

-190.53 

46 

975.14 

-213.47 

47 

970.07 

-237.32 

48 

965.29 

-261.16 
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49 

960 

23 

-282 

90 

50 

954.12 

-307. 

49 

51 

946.47 

-330. 

29 

52 

939 

27 

-352 

84 

53 

974.30 

-109. 

63 

54 

970.63 

-142. 

84 

55 

966 

70 

-167 

29 

56 

961.91 

-191. 

14 

57 

957.13 

-214. 

08 

58 

951 

79 

-237 

32 

59 

946.44 

-260. 

56 

60 

940 . 80 

-284. 

20 

61 

933 

57 

-307 

11 

62 

925.78 

-329. 

84 

63 

920.74 

-351. 

01 

64 

901 

63 

-349 

19 

65 

955.85 

-108. 

18 

66 

957.32 

-125 

15 

67 

952 

37 

-143 

61 

68 

948.50 

-167. 

24 

69 

944.04 

-190 

83 

70 

938 

98 

-214 

31 

71 

933.35 

-237. 

65 

72 

927.14 

-260 

85 

73 

920 

34 

-283 

88 

74 

912.98 

-306. 

74 

75 

905.05 

-329 

40 

76 

888 

55 

-350 

90 

77 

937.17 

-106. 

71 

78 

935.75 

-124 

22 

79 

932 

51 

-143 

22 

80 

928.56 

-167. 

12 

81 

924.00 

-190 

69 

82 

918 

85 

-214 

13 

83 

913.11 

-237. 

43 

84 

906.78 

-260 

58 

85 

899 

86 

-283 

56 

86 

892.35 

-306. 

35 

87 

884.27 

-328 

95 

88 

875 

92 

-353 

93 

89 

916.37 

-105. 

08 

90 

915.97 

-123 

35 

91 

912 

64 

-142 

83 

92 

908.61 

-166. 

96 

93 

903.97 

-190 

50 

94 

898 

72 

-213 

90 

95 

892.86 

-237. 

16 

96 

886.40 

-260 

26 

97 

879 

35 

-283 

18 

98 

871.70 

-305. 

92 

99 

863.46 

-328 

44 

100 

855 

20 

-345 

34 

101 

856.34 

-358 

63 

102 

833.74 

-364 

06 

103 

898 

73 

-103 

69 

104 

896.17 

-122 

49 

105 

892.76 

-142 

44 

106 

888 

64 

-166 

84 

107 

883.90 

-190 

33 

108 

878.55 

-213 

70 

109 

872 

57 

-236 

91 

110 

865.99 

-259. 

96 

111 

858.79 

-282 

82 

112 

850 

99 

-305 

49 

113 

842.60 

-327 

94 

114 

833.61 

-350 

16 

115 

817 

70 

-367 

90 

116 

877.93 

-102 

06 

117 

876.36 

-121 

63 

118 

872 

87 

-142 

05 

119 

868.66 

-166 

67 

120 

863.83 

-190 

13 

121 

858 

37 

-213 

45 

122 

852.27 

-236 

62 

123 

845.55 

-259 

61 

124 

838 

21 

-282 

41 

125 

830.26 

-305 

01 

126 

821.69 

-327 

38 

127 

812 

53 

-349 

51 

128 

802.77 

-371 

49 

129 

861.09 

-101 

.24 

130 

856 

55 

-120 

77 

131 

852.97 

-141 

66 

132 

848.67 

-166 

.51 

133 

843 

74 

-189 

94 

134 

838.16 

-213 

21 

135 

831.94 

-236 

.33 

136 

825 

08 

-259 

26 

137 

817.59 

-282 

00 

138 

809.47 

-304 

.52 

139 

800 

73 

-326 

80 

140 

791.38 

-348 

84 

141 

782.51 

-376 

.35 

142 

763 

03 

-381 

84 

143 

840.66 

-99 

13 

144 

836.73 

-119 

.90 

*Printing  of  the  input  grid  nodes  is  discontinued  here  to  reserve  space 
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1 

299 

328 

327 

1.33 

0.0500 

2 

322 

299 

326 

1.00 

0.0500 

3 

299 

327 

326 

1.00 

0.0500 

4 

324 

323 

357 

1.00 

0.0500 

5 

328 

363 

327 

1.67 

0.0500 

6 

328 

329 

363 

2.00 

0.0500 

7 

329 

364 

363 

2.00 

0.0500 

8 

329 

365 

364 

2.00 

0.0500 

9 

365 

404 

364 

2.00 

0.0500 

10 

364 

404 

403 

2.00 

0.0500 

11 

323 

322 

355 

1.00 

0.0500 

12 

365 

405 

404 

2.00 

0.0500 

13 

325 

324 

356 

1.00 

0.0500 

14 

323 

355 

357 

1.00 

0.0500 

15 

322 

326 

355 

1.00 

0.0500 

16 

327 

362 

326 

1.00 

0.0500 

17 

364 

403 

402 

2.00 

0.0500 

18 

324 

357 

356 

1.00 

0.0500 

19 

327 

363 

362 

1.33 

0.0500 

20 

364 

402 

363 

2.00 

0.0500 

21 

405 

450 

404 

2.00 

0.0500 

22 

357 

395 

356 

1.00 

0.0500 

23 

326 

361 

355 

1.00 

0.0500 

24 

360 

325 

358 

1.00 

0.0500 

25 

326 

362 

361 

1.00 

0.0500 

26 

405 

451 

450 

2.00 

0.0500 

27 

325 

356 

358 

1.00 

0.0500 

28 

363 

401 

362 

1.67 

0.0500 

29 

357 

355 

395 

1.00 

0.0500 

30 

363 

402 

401 

2.00 

0.0500 

31 

403 

404 

449 

2.00 

0.0500 

32 

403 

449 

402 

2.00 

0.0500 

33 

404 

450 

449 

2.00 

0.0500 

34 

356 

394 

358 

1.00 

0.0500 

35 

355 

393 

395 

1.00 

0.0500 

36 

356 

395 

394 

1.00 

0.0500 

37 

355 

361 

393 

1.00 

0.0500 

38 

362 

400 

361 

1.00 

0.0500 

39 

451 

496 

450 

2.00 

0.0500 

40 

362 

401 

400 

1.33 

0.0500 

41 

360 

358 

359 

1.00 

0.0500 

42 

402 

448 

401 

2.06 

0.0500 

43 

451 

497 

496 

2.00 

0.0500 

44 

398 

360 

359 

1.00 

0.0500 

45 

402 

449 

448 

2.06 

0.0500 

46 

450 

495 

449 

2.17 

0.0500 

47 

358 

396 

359 

1.00 

0.0500 

48 

395 

441 

394 

1.00 

0.0500 

49 

361 

399 

393 

1.00 

0.0500 

50 

395 

393 

441 

1.00 

0.0500 

51 

450 

496 

495 

2.17 

0.0500 

52 

358 

394 

396 

1.00 

0.0500 

53 

361 

400 

399 

1.00 

0.0500 

54 

497 

544 

496 

2.53 

0.0500 

55 

401 

447 

400 

1.70 

0  0500 

56 

497 

498 

545 

5.63 

0.0500 

57 

401 

448 

447 

2.09 

0.0500 

58 

497 

545 

544 

3.98 

0.0500 

59 

449 

494 

448 

2.43 

0.0500 

60 

498 

546 

545 

8.29 

0.0500 

61 

449 

495 

494 

2.54 

0.0500 

62 

359 

397 

398 

1.00 

0.0500 

63 

394 

440 

396 

1.00 

0.0500 

64 

393 

439 

441 

1.00 

0.0500 

65 

359 

396 

397 

1.00 

0.0500 

66 

496 

543 

495 

2.71 

0.0500 

67 

394 

441 

440 

1.00 

0.0500 

68 

546 

547 

595 

10.97 

0.0500 

69 

400 

446 

399 

1.22 

0.0500 

70 

393 

399 

439 

1.00 

0.0500 

71 

546 

594 

545 

9.17 

0.0500 

72 

400 

447 

446 

1.58 

0.0500 

73 

496 

544 

543 

3.07 

0.0500 

74 

448 

493 

447 

2.46 

0.0500 

75 

546 

595 

594 

11.06 

0.0500 

76 

547 

596 

595 

11.56 

0.0500 

77 

448 

494 

493 

2.80 

0.0500 

78 

444 

398 

397 

1.00 

0.0500 

79 

495 

542 

494 

3.16 

0.0500 

80 

545 

593 

544 

5.66 

0.0500 

81 

495 

543 

542 

3.33 

0.0500 

82 

441 

487 

440 

1.00 

0.0500 

83 

596 

597 

648 

12.44 

0.0500 

84 

396 

442 

397 

1.00 

0.0500 

85 

596 

647 

595 

12.14 

0.0500 

86 

399 

445 

439 

1.03 

0.0500 

87 

441 

439 

487 

1.00 

0.0500 

88 

396 

440 

442 

1.00 

0.0500 

89 

545 

594 

593 

8.19 

0.0500 

90 

399 

446 

445 

1.24 

0.0500 

91 

447 

492 

446 

2.17 

0.0500 

92 

544 

592 

543 

4.20 

0.0500 

93 

596 

648 

647 

12.46 

0.0500 

94 

447 

493 

492 

2.65 

0.0500 

95 

397 

443 

444 

1.00 

0.0500 

96 

397 

442 

443 

1.00 

0.0500 

97 

544 

593 

592 

5.34 

0.0500 

98 

595 

646 

594 

11.73 

0.0500 

99 

494 

541 

493 

3.39 

0.0500 

100 

597 

650 

648 

12.86 

0 . 0500 

101 

494 

542 

541 

3.64 

0.0500 

102 

595 

647 

646 

12.22 

0.0500 

103 

437 

436 

483 

5.16 

0.0500 

104 

482 

437 

483 

5.27 

0.0500 

105 

543 

591 

542 

4.20 

0.0500 

106 

594 

645 

593 

9.48 

0.0500 

107 

439 

485 

487 

1.05 

0.0500 

108 

440 

486 

442 

1.00 

0.0500 

9-114 


109 

650 

649 

703 

12.82 

0.0500 

110 

650 

702 

648 

13.08 

0.0500 

111 

446 

491 

445 

1.72 

0.0500 

112 

543 

592 

591 

4.71 

0.0500 

113 

436 

438 

483 

5.16 

0.0500 

114 

439 

445 

485 

1.08 

0.0500 

115 

440 

487 

486 

1.00 

0.0500 

116 

438 

484 

483 

5.48 

0.0500 

117 

594 

646 

645 

11.12 

0.0500 

118 

649 

631 

684 

12.25 

0.0500 

119 

446 

492 

491 

2.28 

0 . 0500 

120 

493 

540 

492 

3.29 

0.0500 

121 

489 

444 

443 

1.00 

0.0500 

122 

631 

683 

684 

11.84 

0.0500 

123 

650 

703 

702 

13.08 

0.0500 

124 

649 

684 

703 

12.64 

0.0500 

125 

648 

701 

647 

12.96 

0.0500 

126 

493 

541 

540 

3.68 

0 . 0500 

127 

593 

644 

500 

6.74 

0.0500 

128 

542 

590 

541 

4.11 

0.0^00 

129 

593 

645 

644 

8.34 

0.0500 

130 

647 

700 

646 

12.44 

0.0:00 

131 

648 

702 

701 

13.15 

0 . 0500 

132 

542 

591 

590 

4.50 

0.0500 

133 

438 

435 

481 

5.45 

0.0500 

134 

438 

481 

484 

5.77 

0.0500 

135 

44*^ 

490 

485 

1.40 

0.0500 

136 

487 

533 

486 

1.15 

0.0500 

137 

d92 

643 

591 

5.59 

0 . 0500 

138 

647 

701 

700 

12.86 

0.0500 

139 

442 

488 

443 

1.00 

0.0500 

140 

487 

485 

533 

1.20 

0.0500 

141 

492 

539 

491 

3.03 

0 . 0500 

142 

445 

491 

490 

1.83 

0.0500 

143 

646 

699 

645 

11.27 

0.0500 

144 

442 

486 

488 

1.00 

0.0500 

145 

483 

529 

482 

6.42 

0.0500 

146 

592 

644 

643 

6.48 

0.0500 

147 

492 

540 

539 

3.55 

0.0500 

148 

528 

482 

529 

6.95 

0.0500 

149 

683 

735 

684 

12.21 

0.0500 

150 

443 

488 

489 

1.00 

0,0500 

151 

541 

589 

540 

4.08 

0.0500 

152 

684 

736 

703 

1?.91 

0.0500 

153 

646 

700 

699 

12.10 

0.0500 

154 

683 

682 

734 

11.55 

0.0500 

155 

435 

434 

480 

5.63 

0.0500 

156 

435 

480 

481 

6.07 

0.0500 

157 

541 

590 

589 

4.26 

0.0500 

158 

703 

755 

702 

13.23 

0.0500 

159 

682 

679 

731 

11.20 

0.0500 

160 

483 

484 

529 

6.63 

0.0500 

161 

484 

530 

529 

7.79 

0.0500 

162 

645 

698 

644 

9.20 

0.0500 

163 

683 

734 

735 

12.30 

0.0500 

164 

591 

642 

590 

4.98 

0.0500 

165 

702 

754 

701 

13.36 

0.0500 

166 

486 

532 

488 

1.27 

0.0500 

167 

486 

533 

532 

1.42 

0.0500 

168 

684 

735 

736 

12.90 

0.0500 

169 

682 

731 

734 

11.96 

0.0500 

170 

679 

630 

681 

10.99 

0.0500 

171 

645 

699 

698 

10.49 

0.0500 

172 

591 

643 

642 

5.56 

0.0500 

♦Printing  of  the  input  grid  elements  is  discontinued  here  to  reserve  space 
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1 

1 

0.35 

2 

6 

0.35 

3 

8 

0.35 

4 

12 

0.35 

5 

26 

0.35 

6 

43 

0.3f 

7 

56 

1.00 

8 

60 

1.00 

9 

68 

1.00 

10 

76 

1.00 

11 

83 

1.00 

12 

100 

1.00 

13 

109 

1.00 

14 

118 

1.00 

15 

122 

1.00 

16 

154 

1.00 

17 

159 

1.00 

18 

170 

1.00 

19 

191 

1.00 

20 

201 

1.00 

21 

213 

1.00 

22 

197 

1.00 

23 

148 

1.00 

24 

104 

0.50 

25 

103 

0.50 

26 

113 

0.50 

27 

133 

0.50 

28 

155 

O.'^O 

29 

181 

0.50 

30 

200 

0.50 

31 

196 

0.50 

32 

217 

0.50 

33 

258 

O.5o 

34 

257 

0.50 

35 

283 

0.50 

36 

332 

0.50 

37 

337 

0.50 

38 

355 

0.50 

39 

376 

0.50 

40 

412 

0.50 

41 

430 

0.50 

42 

458 

0.50 

43 

488 

0.50 

44 

489 

0.50 

45 

508 

0.50 

46 

554 

0.50 

47 

580 

0.50 

48 

631 

0.50 

49 

684 

0.50 

50 

772 

0.50 

51 

811 

0.50 

52 

812 

0.50 

53 

849 

0.50 

54 

904 

0.50 

55 

900 

0.50 

56 

911 

0.50 

57 

939 

0.50 

58 

1001 

0.50 

59 

1004 

0.50 

60 

1033 

0.50 

61 

1032 

0.50 

62 

1061 

0.50 

63 

1123 

0.50 

64 

1148 

0.50 

65 

1136 

0.50 

66 

1124 

0.50 

67 

1118 

0.50 

68 

1112 

0.50 

69 

1085 

0.50 

70 

1093 

0.50 

71 

1202 

0.50 

72 

1243 

0.35 

73 

1222 

0.35 

74 

1215 

0.35 

75 

1204 

0.35 

76 

1251 

0.35 

77 

1331 

0.35 

78 

1340 

0.35 

79 

1362 

0.35 

80 

1386 

0.35 

81 

1415 

0.50 

82 

1559 

0.50 

83 

1700 

0.50 

84 

1852 

0.50 

85 

2016 

0.50 

86 

2168 

0.50 

87 

2294 

0.50 

88 

2494 

0.50 

89 

2495 

0.50 

90 

2514 

0.50 

91 

2527 

0.50 

92 

2551 

0.50 

93 

2553 

0.50 

94 

2564 

0.50 

95 

2565 

0.50 

96 

2573 

0.50 

97 

2586 

0.50 

98 

2576 

0.50 

99 

2596 

0.50 

100 

2613 

0.50 

101 

2619 

0.50 

102 

2627 

0.50 

103 

2645 

0.50 

104 

2655 

0.50 

105 

2667 

0.50 

106 

2676 

0.50 

107 

2683 

0.50 

108 

2698 

0.50 

109 

2706 

0.50 

110 

2711 

0.50 

111 

2717 

0.50 

112 

2722 

0.50 

113 

2733 

0.50 

114 

2735 

0.50 

115 

2743 

0.50 

116 

2749 

0.50 

117 

2759 

0.50 

118 

2764 

0.50 

119 

2774 

0.50 

120 

2783 

0.50 

121 

2791 

0.50 

122 

2798 

0.50 

123 

2803 

0.50 

124 

2815 

0.50 

125 

2823 

0.50 

126 

2834 

0.50 

127 

2832 

0.50 

128 

2780 

0.50 

129 

2773 

0.50 

130 

2781 

0.50 

131 

2782 

0.50 

132 

2789 

0.50 

133 

2797 

0.50 

13^ 

2802 

0.50 

135 

2851 

0.50 

136 

2887 

0.50 

137 

2907 

0.50 

138 

2915 

0.50 

139 

2950 

0.50 

140 

2998 

0.50 

141 

3058 

0.50 

142 

3144 

0.50 

143 

3247 

0.50 

144 

3253 

0.50 

145 

3370 

0.50 

146 

3383 

0.50 

147 

3397 

0.50 

148 

3329 

0.50 

149 

3279 

0.50 

150 

3302 

0.50 

151 

3306 

0.50 

152 

3303 

U.50 

153 

3298 

0.50 

154 

3286 

0.50 

155 

3270 

0.50 

156 

3262 

0.50 

157 

3269 

0.50 

158 

3271 

0.50 

159 

3207 

0.50 

160 

3201 

0.50 

161 

3194 

0.50 

162 

3186 

0.50 

163 

3178 

0.50 

164 

3174 

0.50 

165 

3171 

0.50 

166 

3168 

0.50 

167 

3163 

0.50 

168 

3164 

0.50 

169 

3112 

0.50 

170 

3090 

0.50 

171 

3080 

0.50 

172 

3074 

0.50 

173 

3071 

0.50 

174 

3065 

0.50 

175 

3064 

0.50 

176 

3060 

0.50 

177 

2995 

0.50 

178 

2994 

0.50 

179 

2993 

0.50 

180 

2992 

0.50 

181 

2991 

0.50 

182 

2990 

0.50 

183 

2988 

0.50 

184 

2986 

0.50 

185 

2985 

0.50 

186 

3006 

0.50 

187 

3004 

0.50 

188 

2984 

0.50 

189 

2996 

0.50 

190 

3022 

0.50 

191 

3077 

0.50 

192 

3130 

0.45 

193 

3205 

0.45 

194 

3254 

0.45 

195 

3358 

0.50 

196 

3375 

0.45 

197 

3398 

0.45 

198 

3576 

0.45 

199 

3692 

0.45 

200 

3738 

0.45 

201 

3788 

0.45 

202 

3854 

0.45 

203 

3845 

0.45 

204 

3697 

0.45 

205 

3540 

0.45 

206 

3404 

0.45 

207 

3268 

0.45 

20^ 

3242 

0.45 

209 

3165 

0.45 

210 

3131 

0.45 

211 

3116 

0.45 

212 

3051 

0.45 

91'’ 

3003 

0.45 

214 

2972 

0.45 

215 

2953 

0.45 

216 

2932 

0.45 

217 

2910 

0.45 

218 

2893 

0.45 

219 

2862 

0.45 

220 

2835 

0.45 

221 

2777 

0.45 

222 

2705 

0.43 

223 

2582 

0.45 

224 

2511 

0.45 

225 

2400 

0.45 

226 

2270 

0.45 

227 

2206 

0.45 

228 

2127 

0.45 

229 

2004 

0.45 

230 

1826 

0.45 

231 

1614 

0.45 

232 

1405 

0.45 

233 

1187 

0.45 

234 

1026 

0.-5 

235 

869 

0.45 

236 

750 

0.45 

237 

656 

0.45 

238 

559 

0.45 

239 

447 

0.45 

240 

3 '4 

0.45 

241 

247 

0.45 

242 

174 

0.  ,5 

243 

121 

0.35 

244 

78 

0.35 

245 

A4 

0.35 

246 

24 

0.35 

247 

13 

0.35 

248 

4 

0.35 

249 

11 

0.35 

250 

2 

0.35 

251 

3024 

0.00 

252 

3056 

0.50 

BATHSPEC  FEET  0.0  25.00 
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APPENDIX  9-F:  OUTPUT  LISTING  FOR 
MAALAEA  HARBOR,  MAUI,  HAWAII  EXAMPLE 
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COASTAL  MODEL  INC  SYSTEM  (CMS):  HANBO  V  F  R  S  >  0  H  1.0 

-  HASBO  MAAIAEA  HARBON.  MAJl .  N1  -  £x($flNC  COAT  CURAI ION 

CEMSPECS  CARO:  SPECIFICATION  OF  TIUE  AND  CENERAL  SYSTEM  OF  UNITS 


VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

OESCRIP1ION  OF  USAGE: 

VALUE : 

NOTES: 

SUNITS 

UNITS  SYSTEM  USED  IN  COMPUTATIONS 

ENGLiSN 

• 

•••••  CBIDSPEC  CARO:  SPECIFICATION  OF  TKC  FIMITEELEMCMT  GRID 

MAALAEA.IliP 

variable 

DESCRIPTION  Of  USAGE: 

VALUE: 

NOTES: 

*  VARIMLC 

OESCRtPIlON  OF  USAGE: 

VALUE: 

NOTES: 

CRTTPE 

TYPE  OF  FINITE-ELEMENT  GRID 

TRtANC 

•  CUNtfS 

SYSTEM  OF  UNITS  USED  FOR  THE  GRID 

ENGLISH 

NNOO 

NUMBER  OF  GRID  NODES 

1752 

•  NClf 

NUMBER  OF  GRID  ELEMENTS 

7146 

NODR 

NUMBER  OF  NODES  ON  SEMICIRCULAR  BOU 

M  105 

*  NCIB 

NUMBER  Of  BOUNOARr  ELEMENTS 

252 

N8ANO 

•ANOUIOTN  Of  GRID 

T07 

*  RADIUS 

RADILFS  or  SEMICIRCLE 

786.03 

•••••  PftWlNOOU  CARO:  SPECIFICATION  Of  TNE  MODEL  OUTPUT 

VARIABLE 

OESOIPTION  Of  USAGE: 

VALUE: 

NOTES: 

*  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

UPRHOO 

PRINTING  Of  NODAL  SOLUTIONS 

NONE 

*  MAXHOD 

SPECIFIED  MAX  NUMBER  OF  OUTPUT  NODES  T 

NGOOUT 

NUMKR  Of  NODES  SELECTED  FOR  OUTPUT 

0 

•  UPtBSN 

NLMER  Of  SPECIFIED  BASINS 

16 

NAXBSN 

SPECIFIED  MAXINLM  MMBCR  Of  BASINS 

16 

•  MAXELE 

SPECIFIED  MAX  ELEMENTS  IN  AMY  BASI 

IN  7 

tftCOF 

PRINTIMG  Of  OOCfflCIENT  SOLUTIONS 

NO 

•  UPROB 

PRINTING  Of  FINITE  ELEMENT  GRID 

NC 

BASIN  *  HUNKt  OF 

CLEICNTS 

*  BASIN  •  NUMBER  OF 

CLEICNTS 

1 

7 

2 

6 

3 

6 

4 

6 

5 

6 

6 

6 

7 

7 

8 

6 

0 

6 

10 

11 

7 

12 

7 

13 

6 

U 

15 

6 

16 

number  of  wave  CONDITIONS:  1 

UAVC  CONDITION  NUMBER:  t 

VARIABLE 

DESCRIPTION  Of  USAGE: 

VALUE: 

MOTES:  *  VARIABLE 

DESCRIPTION  OF  USAGE: 

VALUE: 

NOTES: 

NDECP 

OECPUATER  IMVE  KCIGR^ 

0.00 

•  TOCCP 

WAVE  PCRIOD 

20.00 

2DEEP 

OCEPLMTER  WAVE  ANGLE 

265.00 

• 

COASTAL  MODELING  S 

Y  S  T  E  M 

(CMS):  NARBD  VERSION  1 

.  0 

*****  BATNSPCC  CARO:  SPECIFICATION  OF  BATNYMETRY/TQPOCRAPNy  • 

variable 

DESCRIPTION  Of  USAGE: 

VALUE: 

NOTES:  *  VARIABLE 

DESCRIPTION  Of  USAGE: 

VALUE: 

NOTES: 

BUHITS 

FARO 

SYSTEM  Of  UNITS  fJR  OEPTN  DATA 

WATER  OEPTN  Of  FAR  REGION 

FEET 

25.000 

•  IBATLRI 

DATLW  FOR  WATER  DEPTHS 

0.00 

NUMBER  or  ELEVATION  CHANGES  «  0 

VARIABLE 

DESCRIPTION  Of  USAGE; 

VALUE: 

NOTES:  *  VARIABLE 

DESCRIPTION  Of  USAGE: 

VALUE: 

NOTES: 

RCFIEC 

■Efl.  COCff.  ALONG  OPEN  COAST  BNORY 

0.10000 

INPUT  PtOCSSSlMC  OOMPICTED; 

EATAl  CtNOit*  0  MAN  I  NOS-  0 
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UAVC  COMOITION 


TK£  OICP  UAUt  UAVI  PARAMTCRS  f08  CASC  1  A»€:  MflCKT*  0.000  PefftOD*  20.000  AMCiC«  265.000 


FOR  the  RASIM  «  1 

1ME  T01AL  MEA  •  O.Ott5C*05 
THE  MEAN  SORT  VAtUE  ATCR  TNE  RASIM  *  I.HU 


FOR  THE  RASIM  «  2 

INC  TOTAL  AREA  •  0.12S9C«O4 
THE  MEAN  SORT  VALUE  OVER  THE  RASIM  •  1.169S 


FOR  THE  RASIM  ■  3 

THE  TOTAL  AREA  «  0.134SC*O4 
TNE  MEAN  SORT  VALUE  OVER  THE  RASIM  •  0.2846 


FOR  THE  RASIM  «  4 

THE  TOTAL  AREA  «  0.1327E«04 
TNE  MEAN  SORT  VALUE  OVER  THE  RASIN  a  0.7501 


FOR  the  RASIN  «  5 

THE  TOTAL  AREA  ■  0.1339E*4K 
THE  MEAN  SORT  VALUE  OVER  TNE  RASIM  •  0.6S54 


FOR  the  RASIM  ■  6 

TNE  TOTAL  AREA  «  O.U02E«04 
THE  MEAN  SORT  VALUE  OVER  TNE  RASIM  «  0.8328 


FOR  TNE  RASIM  >  7 

TNE  TOTAL  AREA  «  0.18S4C«04 
THE  MEAN  SORT  VALUE  OVER  THE  RASIM  >  0.8117 


FOR  THE  RASIM  •  8 

TNE  TOTAL  AREA  •  0.1693E«04 
the  mean  sort  value  over  the  RASIN  «  0.6091 


FOR  THE  RASIM  *  9 

THE  TOTAL  AREA  •  O.ISROE^OS 
THE  MCAM  SORT  VALUE  OVER  THE  RASIM  «  0.7363 


FOR  The  RASIM  «  10 

THE  TOTAL  AREA  •  0.1842E«04 
1NE  MEAN  SORT  VALUE  OVER  TNE  RASIM  «  0.3222 


FOR  TNE  RASIM  «  11 

THE  TOTAL  AREA  «  0.13471*04 
INC  FCAM  SORT  VALUE  O^R  TNE  RASIM  «  0.0551 


FOR  TNE  RASIM  >  12 

TNE  TOTAL  AREA  •  0.13038*04 
TNE  MEAN  SORT  VALUE  OI^R  TNE  RASIM  «  0.0R66 


FOR  TIC  RASIM  •  T3 

TMC  TOTAL  AREA  «  0.1378i«04 
TNE  MEAN  SORT  VALUE  OVER  TNE  RASIM  •  0.2862 


for  TME  RASIM  •  U 

TME  TOTAL  AREA  «  0.1Z36C*04 
IME  MCAM  SORT  VALUE  MR  TNE  8ASIM  «  0.4057 


FOR  TNE  iASIM  >  15 

TNE  TOTAL  AREA  «  0.1608C«04 
TME  MFAH  SORT  VALUE  ACR  TME  RASIM  •  0.5103 


TOR  TNC  USIM  >  16 

TNE  TOTAL  AREA  »  0.t320E«04 
TNE  MCAM  SORT  VALUE  OVER  TMC  RASIM  •  O.RIH 
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APPENDIX  A:  CMSGRID 


A-1 


1.  Numerical  models  consist  of  one  or  more  mathematical  equations  that 
define  or  describe  the  physical  processes  of  a  system.  The  equations  often 
contain  partial  derivatives  that  define  how  flow  field  variables  change  with 
respect  to  time  and/or  space.  The  models  use  mathematical  (finite  difference 
or  finite  element)  approximations  to  represent  these  continuous  equations  at 
discrete  locations.  The  continuum  is,  therefore,  represented  by  discrete 
points  In  time  and  space.  Hence,  a  computational  grid  Is  employed  by  the 
model  to  define  the  flow  field  at  discrete  points. 

2.  A  grid  Is  composed  of  a  lattice  network  of  cells,  and  each  cell  has 
certain  flow  field  parameters  associated  with  It.  In  the  case  of  the  WES 
Implicit  Flooding  Model  (WIFM) ,  these  parameters  Include  water  depths,  water 
and  wind  velocities,  and  water  surface  elevations.  A  model  Is  expected  to 
accurately  predict  flow  parameters  In  the  domain  of  Interest,  and  model 
accuracy  is  dependent,  in  part,  on  how  well  the  specified  grid  resolution 
represents  the  spatial  domain  and  the  flow  field.  The  methodology  used  to 
create  computational  grids  for  models  residing  in  the  Coastal  Modeling  System 
(CMS)  is  presented  here. 

3.  At  the  present  time  this  package  has  the  capability  to  generate 
grids  In  a  stretched  rectangular  coordinate  system.  Uniformly  spaced  grids, 
which  are  a  subset  of  this  group,  can  also  be  generated.  The  programs 
contained  In  this  package  are  listed  In  Table  A-1. 

Table  A-1 


A  V  KW  vf Jl 


MAPIT  Stretch  rectangular  coordinate  grid  generator. 

DRAWIT  Graphical  program  to  plot  grids  generated  by  MAPIT. 

LISTIT  Program  to  print  grid  coordinate  points. 


Computational  Technique  of  Program  MAPIT 


4.  Program  MAPIT  is  designed  to  calculate  the  mapping  function  that 
relates  a  variably  spaced  grid  in  prototype  space  to  a  uniformly  spaced  grid 
in  computational  space.  The  function  defining  the  mapping  from  prototype 
space  (x)  to  computational  space  (a)  is; 

X  =  a  +  jba*'  (Al) 

where 

X  -  actual  mapping  distance  from  the  origin 

a  -  distance  from  the  origin  in  computational  space  (which  can  also 
be  thought  of  as  the  cell  index  number  assuming  a  constant 
computational  grid  cell  size  of  1.0) 

a,  b,  c  “  coefficients  calculated  by  the  program  (Figure  A-1) 

The  entire  prototype  space  to  be  mapped  can  be  separated  into  user-specified 
regions  of  arbitrary  length  defined  by  end  points  x^,  Xj. . .x„  (for  n-1 
regions) ,  and  the  mapping  function  is  applied  to  each  region.  Values  of  the 
three  coefficients  are  thus  derived  for  each  of  the  n-1  regions.  The  values 
of  a  ,  b  ,  and  c  are  determined  by  requiring  continuity  of  both  the 
function,  x  ,  and  its  first  derivative  from  region  to  region.  This 
constraint  provides  a  smoothly  varying  grid. 

5.  For  any  region  the  following  relationships  must  be  satisfied: 

Xj  =  a  +  ba\  (A2) 


x‘i 


(A3) 


i  +1 


i  +  2 


i  +  3 


Figure  A-1.  Variably-spaced  grid 


a  +  Jbaf*i 


Xi*t  - 


(A4) 


■  bca 


C-1 

in 


(A5) 


where  the  subscripts  I  and  i-fi  refer  to  the  beginning  and  ending  points  of 
the  region.  The  three  coefficients  (a,  b,  c)  for  each  region  are  derived  from 
four  nonlinear  equations,  over -cons trained  by  the  known  values  of  Xj.  ,  x^+i  , 
*'i  .  x'l+i  .  ®i  .  and  Oi+i  . 

6.  In  practice,  the  solution  procedure  of  MAPI!  operates  somewhat 

differently.  The  algorithm  assumes  that  regions  are  mapped  In  a  sequential 
order  from  1  to  (n-I),  and  that  the  a's  are  always  positive  Integers.  For 
any  given  region,  the  values  of  Xj  ,  x'l  ,  and  are  known  from  the 

computations  for  the  previous  region.  (The  user  specifies  these  values  for 
the  first  region. )  The  user  specifies  the  distance  to  the  far  end  of  the 
region  (x^+i)  and  the  cell  size  at  the  far  end  of  the  region  (x  'i+i) .  while  the 
number  of  cells  (0^+1)  Is  computed  by  the  program  in  a  preliminary 
computation.  It  should  be  noted  that  the  value  (0^+1  -  oi)  gives  the  number  of 
grid  cells  that  lie  between  the  endpoints  of  a  region. 

7.  Providing  that  a  ,  b  ,  and  c  have  been  detemnlned,  an  optimal 

value  of  can  be  chosen,  such  that  the  difference  between  the  desired 

value  of  Xi+i  and  that  calculated  from  Equation  A4  can  be  minimized.  The 
three  coefficients,  derived  from  Equations  A2  through  A5,  are  presented  below; 


_  _  ,  ,  log  (x;/Xi»i) 
log  (ax/ox*,) 

(A6) 

a  -  Xx  bax  -  Xx  ^ 

(A7) 

jb  -  (Xx  -  a)  /ttx 

(A8) 

8.  This  preliminary  calculation  In  MAPIT  starts  by  assuming  an  ox^i 
value  greater  than  Ox  .  The  values  of  a  ,  b  ,  and  c  are  then  determined 
from  Equations  A6  through  A8,  and  a  calculated  value  of  Xx+x  is  obtained 
from  Equation  A4.  This  computed  value  is  compared  with  the  desired  value  of 
Xx+x  :  the  value  of  Ox+i  i®  incremented  or  decremented;  and  the  procedure  is 
repeated  until  the  calculated  Xx+x  value  becomes  approximately  equal  to  the 
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desired  value.  The  program  warns  the  user  if  the  region  is  too  small  to  fit  a 
single  cell,  or  if  more  than  500  cells  appear  in  any  one  region.  The  non¬ 
linear  system  of  equations  are  solved  iteratively  to  assure  that  a  convergent 
value  of  the  exponent  c  is  generated.  Two  procedures  are  used  in  MAPIT,  and 
they  are  expressed  mathematically  below: 


Procedure  I 


log 

(Xi»i  -  Xi)Cjt  ^  , 

CtiXi 

log  (a^.i/a^) 

(A9) 


Procedure  II 


(AlO) 


where  k  is  the  Iteration  counter.  These  two  relationships  are  derived  from 
Equations  A2  through  AS.  Both  equations  contain  one  zero  root,  as  well  as  the 
root  of  Interest.  The  roots  of  Interest  are  then  averaged,  and  the  average 
value  of  c  is  used  for  computing  a  and  b  .  Procedure  I  also  has  an 
asymptote : 

c,  =  (All) 

Xui  -  JCl 

9.  Both  procedures  are  solved  using  the  Newton-Raphson  method  and  are 
compared  with  each  other.  All  four  roots  of  the  two  equations  are  found  and 
checked  in  order  to  find  problems  with  pathological  solutions  for  c  and  poor 
convergence  in  iteration.  Following  the  solution  for  c  ,  the  values  of  a 
and  b  are  found  from  Equations  A7  and  A8.  It  should  be  noted  that 
is  never  used  in  the  calculations  of  the  three  coefficients  computed  from 
Equations  A7  through  AlO.  The  three  coefficients  are  computed  using 
previously  known  values  of  c  and  the  given  Xj+i  .  The  values  of  the 
coefficients  satisfy  the  relationships  of  Equations  A2  through  A4,  but  not 
Equation  AS.  MAPIT  recalculates  from  Equation  AS  to  complete  the 

problem,  and  it  displays  the  results  for  the  region  to  the  user.  The  user 
then  has  the  option  to  continue  to  the  next  region,  try  the  same  region  again 
with  different  Inputs,  or  back  up  to  a  previous  region.  If  the  user  does  not 
want  the  value  of  recalculated  by  the  program,  but  requires  specific 
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(A21) 


These  two  equations  can  be  manipulated  to  yield  two  pairs  of  equations  in 
and  C2  : 
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(A22) 


(A23) 


(A24) 


(A25) 

where  the  k  superscript  is  an  Iteration  counter.  The  coefficients  Ci  and 
C2  can  be  calculated  from  either  of  the  above  pairs  of  equations,  and  the 
remaining  unknowns  can  be  found  by  substitution. 

11,  The  actual  algorithm  for  the  double  region  routine  is  rather 
complicated  due  to  the  nature  of  Equations  A22  through  A24.  Equation  A21 
represents  a  straight  line  with  a  negative  slope  in  Cj  -  C2  space,  whereas 
Equations  A23  through  A25  each  have  one  asymptote  for  their  dependent 
variable.  These  asymptotes  are  given  by: 

(A26) 


for  Equation  A23,  and 


for  Equation  A25. 

12.  The  plot  of  Equations  A21  through  A27  is  shown  in  Figure  A-2 
together  with  the  two  possible  solution  paths  suggested  by  the  equation  pairs 
of  Equations  A22  and  A23,  and  A24  and  A25.  The  major  difficulties  in  the 
solution  algorithm  are  choosing  the  appropriate  starting  values  of  Cj  and 


log  1  ♦  - i —  (x^  - 

_ _ 

log 


(A27) 
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C2  and  determining  which  of  the  two  equation  pairs  yield  a  convergent 
solution.  Since  the  asymptotic  values  of  Cj  and  C2  can  be  determined  from 
Equations  A26  and  A27,  starting  values  are  arbitrarily  chosen  as  a  specified 
percentage  of  these  asymptotic  values. 

13.  In  attempting  to  find  a  convergent  solution,  a  first  estimate  is 
obtained  from  Equations  A22  and  A23 .  If  the  value  of  C2  becomes  zero , 
Equations  A24  and  A25  are  used  with  the  starting  values.  Should  the  value  of 
Cl  also  become  zero,  then  the  starting  point  lies  too  close  to  the 
asymptotes.  A  new  starting  point  closer  to  the  origin  is  then  defined,  and 
the  whole  calculation  cycle  is  repeated.  Any  time  both  equation  sets  are 
satisfied  by  a  zero  solution  or  fail  to  converge  within  a  set  number  of 
iterations,  the  starting  point  is  redefined,  and  the  iteration  procedure  is 
repeated.  Calculations  cease  after  10  different  starting  points  have  been 
tried,  and  the  user  is  warned  about  nonconvergence  of  the  input  values. 

14.  It  must  be  pointed  out  that  not  every  possible  set  of  inputs  for 
the  double  region  routine  will  yield  a  solution.  The  algorithm  is  coded  to 
make  a  reasonable  attempt  to  find  a  solution;  however,  the  user  is  warned 
about  nonconvergent  cases  or  pathological  functions.  The  procedure 

also  attempts  to  resolve  other  problems,  such  as  attempts  to  take  the 
logarithm  of  negative  numbers. 


Figure  A- 2.  Graphic  solution  of  double  region  procedure 
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Generating  Stretch  Rectilinear  Grids 

15.  Three  basic  steps  are  required  to  generate  stretched  rectilinear 

grids : 

a.  Defining  the  grid  orientation  and  Units. 

b.  Determining  the  grid  cell  resolution  in  the  seaward  direction. 

c.  Determining  the  grid  cell  resolution  in  the  longshore 
direction. 

16.  The  following  discussion  presents  guidelines  for  the  above  topics; 
however,  due  to  the  complexity  of  coastal  regions,  these  guidelines  will  not 
be  applicable  to  every  situation  encountered.  Hence,  knowledge  of  the 
capabilities  and  limitations  of  the  model  intended  to  be  used  is  needed  in 
developing  computational  grids. 

Grid  orientation  and  limits 

17.  The  user  should  select  a  detailed  chart  or  map  of  the  study  area 
with  sufficient  resolution  of  the  coastline  and  hydraulic  features  to  resolve 
such  features  as  sharp  depth  gradients  or  reefs.  Haps  constructed  from  a 
Mercator  projection  should  be  used,  especially  if  multiple  maps  are  needed  to 
define  the  study  area.  Mercator  projection  preserves  the  angle  relationship, 
allowing  the  grid  to  be  transferred  from  one  scale  to  another  without 
distortion. 

18.  The  user  should  overlay  the  map  with  a  sheet  of  Mylar  or  tracing 
paper  and  draw  a  line  on  the  Mylar  that  best  describes  the  coastline 
orientation  along  the  reach  that  is  of  primary  interest.  A  line  perpendicular 
to  any  inlet  or  channel  of  interest  should  be  drawn.  These  lines  provide 
guidance  concerning  orientation  of  grid  axes. 

19.  The  X  and  y  axes  can  be  oriented  arbitrarily  as  long  as  a  ri^t' 
handed  coordinate  system  is  used.  However,  the  choice  of  alignment  for  the 
grid  axes  is  extremely  Important,  especially  when  the  geometric  features  of 
the  area  to  be  modeled  are  complex.  Because  the  modeled  area  must  be 
represented  with  rectangular  cells,  the  user  should  keep  in  mind  that 
minimizing  any  stair-stepped  representation  of  shorelines,  structures,  and/or 
major  channels  will  produce  the  most  suitable  grid. 

20.  For  UIFM  simulations,  the  user  should  estimate  the  maxiiaum  flood 
height  resulting  from  extreme  tidal-  or  storm- induced  water  levels  that  will 
be  simulated  by  the  model.  This  estimate  can  usually  be  supplied  from 


A-9 


historical  records;  if  not,  approximate  values  can  be  computed  by  the 
procedures  presented  in  EM  1110- 2 -1412.  Next,  a  freeboard  of  at  least  3  ft 
should  be  added  to  the  maximum  flood  height.  The  user  then  locates  points  or 
line  segments  delineating  the  extent  of  flooding  and  uses  these  points  to 
define  the  boundaries  of  the  grid.  Topographic  features  that  prevent  flooding 
should  also  be  considered  when  defining  the  model  domain, 

21.  For  a  storm  surge  simulation,  the  seaward  boundary  should  extend  to 
the  seaward  edge  of  the  Continental  Shelf.  Therefore,  the  user  should  draw 
another  line  on  the  Mylar  parallel  to  the  reference  line,  at  the  Continental 
Shelf.  The  adjacent,  or  lateral,  boundaries  must  be  placed  far  enough  from 
the  area  of  Interest  so  that  inaccuracies  caused  by  uncertainties  in  the 
boxindary  values  specified  in  the  model  are  minimized.  As  a  rule  of  thumb,  the 
grid  should  extend  laterally  from  the  area  of  interest  in  each  direction,  a 
distance  of  at  least  1.5  to  2.0  times  the  distance  from  the  coastline  to  the 
shelf. 

22.  For  a  tidal  circulation  investigation,  the  grid  limits  are 
dependent  on  the  size  and  shape  of  the  area  of  interest  and  where  data  are 
available  for  establishing  a  proper  boundary  condition.  For  example,  back-bay 
areas  in  the  model  may  be  influenced  by  river/channel  systems.  The  model  grid 
should  extend  into  such  systems  to  a  point  where  the  water  level,  flow  rate, 
or  velocity  have  been  measured  and  can  be  used  to  establish  a  boundary 
condition.  In  the  open  coast  area,  the  seaward  and  lateral  open  boundaries 
should  extend  far  enough  from  the  area  of  interest  so  that  computations  in  the 
area  of  Interest  are  not  significantly  affected  by  inaccuracies  in  boundary 
specification.  Again,  data  (usually  water  level  measurements  or  tidal 
constituents)  should  be  available  in  the  open  coastal  area  to  be  used  as 
boundary  conditions. 

23.  Many  WIFM  applications  Involve  consideration  of  tidal  hydrodynamics 
at  structured  Inlets.  A  general  rule  of  thumb  is  to  locate  open  water 
boundaries  a  distance  from  the  inlet  equivalent  to  5  times  the  length  of  the 
inlet  structure. 

24.  In  storm  or  tidal  investigations,  a  grid  sensitivity  study  can  be 
performed.  This  type  of  test  is  usually  performed  to  minimize  the  size  of  the 
open  ocean  portion  of  a  grid.  The  test  is  done  by  first  developing  a  grid 
with  limits  exceeding  the  specifications  mentioned  in  earlier  paragraphs. 
Having  made  good  engineering  estimates  for  other  model  input  parameters 
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(depth,  friction,  etc.),  a  test  is  run  with  the  large  grid.  The  test  is  then 
repeated  after  reducing  the  grid  size  in  both  seaward  and  lateral  directions. 
The  results  in  the  area  of  interest  are  checked  to  determine  the  impact  of  the 
new  boundary  location. 

Seaward  grid  cell  resolution 

25.  A  profile  of  the  seabed  is  drawn  on  a  separate  sheet  of  Mylar, 
running  from  the  onshore  boundary  to  the  seaward  boundary.  The  bottom  profile 
is  simplified  by  drawing  straight  lines  that  represent  regions  having 
approximately  the  same  slope.  (Normally  four  to  eight  regions  are 
sufficient.)  A  separate  stretching  function  (Equation  A2)  should  be  applied 
to  each  region  in  order  to  generate  grid  cells  that  adequately  define  the 
area.  As  a  first  attempt  at  creating  a  g;:id,  a  constant  value  of  the  ratio, 
Ax/L  ,  (where  Ax  is  the  grid  cell  size  ana  L  is  the  wavelength)  should  be 
maintained. 

26.  Cell  dimensions  are  first  chosen  for  the  area  of  interest.  In  this 
region  the  cells  should  be  square,  or  nearly  square,  and  have  a  greater 
resolution  (i.e.,  more  cells  per  unit  area)  than  in  the  remaining  regions. 

Cell  sizes  must  be  small  enough  so  that  the  hydraulic  features  are  resolved. 
However,  computer  costs  fo’'  executing  the  model  will  be  prohibitive  if  the 
grid  has  too  many  cells  or  if  the  minimum  cell  size  forces  the  choice  of  a 
very  small  time-step  according  to  the  Courant  stability  constraint. 

27.  Seaward  of  the  area  of  interest,  cell  dimensions  can  usually  be 
increased.  This  is  performed  by  smoothly  increasing  cell  dimension  sizes  over 
the  distance  defined  by  the  slope  region.  The  first  cell  in  a  region  should 
not  increase  by  more  than  25  percent  of  the  size  of  the  last  cell  in  the 
previous  region.  The  largest  cell  in  the  grid,  normally  located  at  the 
seaward  boundary,  should  not  be  greater  than  20  times  tne  size  of  the  smallest 
cell  in  the  grid. 

28.  Grid  sizes  may  increase  in  the  inland  direction  away  from  the  area 
of  interest.  However,  care  should  be  taken  to  sufficiently  resolve  the  Inland 
water/land  system.  Proper  resolution  will  ensure  the  flooding  and  drying 
algorithm  in  model  WIFM  can  be  accurately  applied  to  this  area. 

Longshore  grid  cell  resolution 

29.  Longshore  grid  cell  resolution  is  ietermined  from  the  variability 
of  the  coastline  as  opposed  to  bed  slope  in  the  seaward  direction.  However, 
the  concepts  of  increasing  the  resolution  in  areas  of  rapid  change  are  the 
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same.  Greater  resolution  is  needed  in  areas  where  the  landforms  or  other 
hydraulic  features  have  significant  influence  on  hydrodynamics  in  the  region 
of  interest.  Grid  lines  should  be  placed  to  match  the  orientation  of  these 
features,  where  possible. 

30.  As  a  practical  guideline,  there  are  two  basic  methods  for  ensuring 
good  grid  resolution  of  small  hydraulic  features  such  as  inlets.  The  first 
method  is  to  put  a  partition  in  the  middle  of  the  inlet.  If  a  suitably  small 
cell  width  is  chosen  for  this  partition,  with  larger  cell  sizes  at  the  two 
nearest  endpoints,  then  the  inlet  will  be  modeled  with  a  cell  group  smallest 
in  the  center  of  the  inlet  and  largest  at  its  edges.  If  a  relatively  constant 
cell  size  is  desired  across  an  inlet,  then  it  is  best  to  place  a  partition 
point  at  each  edge  of  the  inlet,  so  that  the  inlet  becomes  one  region.  Equal 
cell  widths  can  be  defined  at  the  end  points,  resulting  in  nearly  constant 
cell  widths  across  the  inlet.  This  method  has  the  advantages  of  placing 
partition  lines  at  the  land-water  boundaries  of  the  inlet  and  ensuring  a 
specific  grid  resolution;  however,  this  often  generates  a  larger  number  of 
cells  over  the  entire  grid  because  the  fine  resolution  in  the  inlet  will  be 
"carried"  into  the  open  ocean  area. 

31.  For  featureless  terrain  bounded  by  high- resolution  regions,  two 
partitioning  methods  can  be  used  to  minimize  the  number  of  required  grid 
cells.  One  method  divides  the  area  into  two  regions,  containing  partitions 
with  small  cells  in  the  required  areas.  The  second  method  divides  the  area 
into  three  regions,  with  small  cells  at  the  outer  partitions  and  large  cells 
at  the  two  inner  partitions.  This  method  creates  large  cells  in  the  middle 
region  and  rapid  changes  in  cell  size  in  the  two  outer  regions  of  the  area. 

The  method  that  produces  the  minimum  number  of  cells  is  preferable. 

Additional  considerations  for  grid  generation 

32.  As  a  practical  guideline,  channels  should  be  oriented  approximately 
parallel  to  the  grid  axes  to  avoid  stair-stepping.  Orientation  at  a  45-degree 
angle  for  square  grid  cells  would  maximize  stair-stepping  and  should  be 
avoided.  Another  method  of  avoiding  stair-stepping  is  to  alter  the 
orientation  of  water  bodies  in  nonsensitive  areas  while  preserving  storage 
capacity,  as  shown  in  Figure  A-3. 

33.  The  ratio  of  the  cell  size  in  the  longshore  direction  to  the  cell 
size  in  the  on- offshore  direction,  or  aspect  ratio,  should  also  be  examined 
and  considered  when  generating  a  grid.  For  example,  model  RCPWAVE  requires 
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large  aspect  ratios  to  resolve  large  input  wave  angles.  An  aspect  ratio  of 
two  is  typically  used  for  RCPWAVE  applications.  On  the  other  hand, 
hydrodynamic  models,  such  as  WIFM  and  CLHYD,  produce  most  accurate  results 
with  an  aspect  ratio  of  1,  indicating  "square"  grid  cells.  An  aspect  ratio 
within  the  range  0.2  and  5  produces  adequate  results  in  the  area  of  interest 
and  the  aspect  ratio  can  be  as  much  as  20  away  from  the  area  of  interest. 

34.  Lastly,  the  user  should  be  aware  of  the  implications  of  two 
stability  criteria  on  grid  generation,  the  Courant  condition  and  the  diffusion 
number.  The  Courant  condition 


- 

Ax/  A  t 


defines  the  maximum  permissible  time-step  size  for  a  given  value  of  , 
where  g  is  the  gravitational  acceleration.  Ax  is  the  dimension  of  the 
smallest  grid  cell  within  the  computational  domain,  H  is  the  depth  at  that 
cell,  and  At  is  the  time-step  size.  Therefore,  a  fine -resolution  grid  will 
require  a  small  time -step  size  and  a  large  number  of  time -steps  for  a  given 
simulation  length,  which  can  become  computation  prohibitive.  The  Courant 
number,  C^.  ,  is  ideally  less  than  0.5,  but  results  can  be  obtained  for 
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less  than  7.0.  It  is  recommended  that  a  Courant  number  on  the  order  of  1.0  tc 
7.0  be  used  for  WIFM  and  CLHYD  applications. 

35.  The  second  stability  criterion,  the  advection  limit,  is  the  iiaxiaium 
allowable  time-step.  At  ,  based  on  the  time  for  a  particle  to  travel  through 
the  smallest  grid  cell: 

A.  .  ^  or  ^ 

where  Ax  and  Ay  are  the  smallest  grid  cells  in  the  x-  and  y-  directions, 
respectively  and  U  and  V  are  the  particle  velocities  in  the  x-  and 
y- directions ,  respectively.  Experienced  modelers  usually  select  a  time -step 
somewhat  "less  than"  this  limit,  rather  than  "equal  to"  the  limiting  value. 

Program  MAPIT 

36.  Program  MAPIT  generates  computational  grids  for  the  models  residing 
in  CMS.  Presently,  this  program  will  generate  only  grids  having  stretched  or 
uniform  rectilinear  coordinate  systems  (i.e.,  models  WIFM,  SPH,  RCPWAVE, 

CLHYD,  and  SHALWV) .  Guidelines  for  developing  a  stretched  rectilinear  grid 
have  been  discussed  previously  in  this  Appendix. 

37.  Computer  costs  incurred  in  executing  the  models  can  be  reduced  by 
selecting  the  x-direction  axis  so  that  it  contains  more  grid  cells  than  the  y- 
axis.  Cost  reduction  is  related  to  the  manner  in  which  two-dimensional  arrays 
are  stored.  The  x-  and  y-direction  grid  axes  can  be  computed,  or  mapped,  in 
either  order;  however,  the  following  requirements  must  be  met: 

fl.  Each  region  must  be  mapped  in  sequence,  starting  at  the  axis 
origin. 

l2.  Distances  are  measured  from  the  axis  origin.  A  common  choice 
for  distance  units  is  map  inches  so  a  map  overlay  can  be 
created. 

£.  Grid  cells  are  numbered  sequentially,  with  the  first  cell  at 
the  axis  origin. 

Program  input  data 

38.  Program  MAPIT  is  executed  interactively.  Hence,  the  program  will 
prompt  the  user  for  the  input  data.  MAPIT  responses  require  capital  letters. 
An  instruction  menu,  listing  the  valid  user  commands  and  corresponding 
variables,  is  presented  in  Table  A-2. 
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Table  A- 2 


Instruction  Menu  for  Program  MAPIT 


Conunand 


? 


SINGLE 


DOUBLE 


BACKUP 


SUMMARY 


ENDDIR 

DEBUG 


Input  Data 


X2  X2P 


X3  X3P  L3  L2 


IREG 


"ON"  "OFF" 


Defaults  Description _ 

Invokes  the  HELP  utility 
that  lists  valid  user 
responses . 


none 


SINGLE  region  mapping 
X2  •  distance  from 
origin  to  far 
end  of  region. 

X2P  -  cell  width  at 
last  cell  in 
region. 


none  DOUBLE  region  mapping 

X3  -  distance  to  far 
end  of  region 
partition. 

X3P  -  cell  width  of 
last  cell  in 
region. 

L3  -  cell  number  of 
last  cell  in 
region. 

L2  -  cell  number  of 
cell  at  center 
of  region. 

none  Recompute  region  mapping 

IREG  -  region  number 
to  be  remapped. 

none  Produces  a  summary  of 

all  mapping  previously 
performed. 

none  Ends  mapping  direction. 

"OFF"  Prints  diagnostics  and 

intermediate 
computations . 
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39.  A  SINGLE  command  specifies  a  region  composed  of  one  stretching 
function.  Variable  X2  defines  the  distance  from  the  axis  origin  to  the  far 
edge,  or  partition,  of  the  region.  Variable  X2P  defines  the  grid  cell  width 
at  the  far  edge. 

40.  A  DOUBLE  command  specifies  a  region  composed  of  two  stretching 
functions.  Variable  X3  defines  the  distance  from  the  axis  origin  to  the  far 
edge,  or  partition  of  the  region,  and  variable  X3P  Is  the  width  of  the  last 
cell  In  that  region.  The  user  must  also  specify  the  cell  number  at  the  far 
edge  of  the  region  (variable  L3)  and  the  cell  number  at  the  center  of  the 
region  (variable  L2). 

41.  The  solution  algorithm  In  program  MAPIT  will  diverge  If  Improper 
values  are  entered  for  a  region.  If  the  solution  does  diverge,  convergence 
can  normally  be  achieved  by  adjusting  the  values  for  variables  X3P  and/or  L2. 
Additional  Information  concerning  the  divergence/convergence  of  the 
computational  algorithm  Is  discussed  In  the  section  titled  "Computational 
Technique  of  Program  MAPIT . " 

42.  An  option  is  Included  in  program  MAPIT  to  allow  the  user  to 
recompute  regions  (option  BACKUP).  However,  all  regions  mapped  subsequent  to 
the  Initial  attempt  of  a  remapped  region  will  be  deleted. 

43.  Mapping  Is  terminated  by  entering  the  ENDDIR  command.  The  user  Is 
then  prompted  to  map  the  remaining  direction  or  terminate  the  mapping  session. 
Program  execution 

44.  The  program  will  prompt  the  user  for; 

A  mapping  direction  (either  x-  or  y-axls). 

The  Initial  distance  to  the  grid  origin  (x)  which  is  usually 
set  to  0.0. 

£.  The  Initial  grid  cell  Index  number  (ALPHA) ,  which  Is  usually  set 
to  1. 

d.  Initial  cell  width. 

45.  The  Interactive  session  begins  by  entering  the  command: 
h2crplcl :  Iarry$/tt3/&aer|life0/«»tf 

on  the  CRAY  Y-YMP  supercomputer  located  at  WES  (see  Chapter  2).  It  should  be 
noted  that  user  entries  are  shown  as  shaded  and  the  CMS  response  "screens"  are 
shaded  boxes. 
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The  CMS  responds: 


C  M  S  COMPONENTS 


*  Options 


*  CMSGRID  (Haps,  plots,  and  lists  the  nunerlcal  grid) 


*  CMSHODEL  (Compiles,  links,  loads,  and  executes 

*  numerical  models)  . . 


*  CMSPOST  (Plots  and  lists  model  outputs) 


*  CMSUTIL  (Additional  "utility"  programs)  — . 

* 

*  CMSSAMP  (Sample  ihput  and  output  files  for  each  model) 


Enter  option  number 
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The  CMS  responds: 


I 
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Return 

for  more _ 

Enter  option  number  . >  | 
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Q  O  O 


HAPIT:  (Stretched/constant  rectangular 
coordinate  grid  generator)  >> 


DRAWIT:  (Graphical  program  to  plot  grids 

generated  by  MAPIT)  - - - 


LISTIT:  (Program  to  print  grid  coordinate 

points)  - - - ... 


EXIT:  (Terminate  computer  session) 
** 


idItliUUUUifaUW 


The  user  Is  prompted  to  select  a  CMSGRID  component: 
Enter  option  number  . . . >  || 

The  CMS  responds: 


X  X 

X 

XXXXXX 

XXXXXXX 

XXXXXXX 

XX  XX 

X  X 

X  X 

X 

X^'.."'-v' 

XX  XX 

X  X 

X  X 

X 

X 

X  X  X  X 

XXXXXXX 

XXXXXX 

X 

X- 

XXX 

X  X 

X 

X 

:  ■  X  ■ 

X  X 

X  X 

X 

X 

X 

X  X 

X  X 

X 

XXXXXXX 

X 

Return 

for  more. . . 

The  user  Is  prompted  to  provide  a  name  for  the  output  file  which  will  contain 
the  grid  stretching  coefficients: 

Enter  output  file  name 

The  user  Is  prompted  to  select  a  mapping  direction: 


SPECIFY  MAPPING  DIRECTION  (X  OR  Y) : 

NOTE:  REGIONS  MUST  BE  MAPPED  IN  SEQUENCE... 


The  user  is  prompted  for  an  initial  distance  for  the  grid  origin  (x)  and  an 
initial  grid  cell  index  number  (ALPHA) : 


SPECIFY  INITIAL  X  DISTANCE  AND  ALPHA 

(CARRIAGE  RETURN  EMPLOYS  DEFAULTS:  X-0.0  AND  ALPHA-1) 

***  USE  ONLY  INTEGERS  FOR  ALL  ALPHAS  INPUT I ! f 


pji  X 


The  user  is  prompted  for  an  initial  cell  size  (x* ) : 


SPECIFY  ASSOCIATED  DERIVATIVE  X-PRIME: 


The  user  may  now  chose  to  display  a  menu  of  valid  commands: 

CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

.  .  .ENTER  "MENU"  OR  ?"  TO  SEE  MENU.  . . 

. . .PLEASE  USE  UPPERCASE. . . 

I 

The  program  responds: 


INSTRUCTION  MENU  FOR  PROGRAM  MAPIT: 


■  M  III  ■  M \\wm 

MENU 

SINGLE 

X2  X2P 

NONE 

PRINTS  THIS  MENU 

SINGLE  REGION  MAPPING 

DOUBLE 

X3  X3P  AL3  AL2 

NONE 

DOUBLE  REGION  MAPPING 

BACKUP 

REG 

CURRENT  REG 

BACK  UP/REDO  REGION  (REG-0 

SUMMARY 

SO 

ENDDIR 

AND 

DEBUG 

"ON"  OR  "OFF" 

"OFF" 

RESTARTS  DIR) 

SUMMARIZES  MAPPING  WORK  DONE 
FAR 

ENDS  THIS  MAPPING  DIRECTION 
SAVES  DATA 

PRINTING  SWITCH  FOR  PROGRAM 

DEBUGGING 

AN  EXPLANATION  OF  THE  INPUT  DATA: 

X2  -  DISTANCE  AT  RIGHT  SIDE  OF  A  SINGLE  REGION 

X2P  -  SLOPE  (X-PRIME)  AT  RIGHT  SIDE  OF  A  SINGLE  REGION 

X3  -  DISTANCE  AT  FAR  END  OF  THE  SECOND  REGION 

X3P  -  SLOPE  (X-PRIME)  AT  FAR  END  OF  THE  SECOND  REGION 

AU  -  ALPHA  AT  FAR  END  OF  THE  SECOND  REGION 

AL2  -  ALPHA  AT  THE  MIDDLE  REGION  LINE  OF  A  DOUBLE  REGION 

REG  -  THE  REGION  NUMBER  YOU  WISH  TO  REMAP 

(NOTE  ALL  MAPPING  COMPUTATIONS  AFTER  THIS  REGION  ARE 
WRITTEN  OVER  AND  WIPED  OUT) _ 
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The  user  selects  a  single  region  15  units  long  with  an  ending  cell  size  of  1 
unit: 


CHCX)SE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
...ENTER  "MENU"  OR  "?"  TO  SEE  MENU... 
. . .PLEASE  USE  UPPERCASE. . . 

smas  n*  Xi’ 


since  the  initial  cell  size  (x')  was  1  ur.It,  then  the  cells  for  this  region 
are  a  constant  value  of  1  unit.  The  program  responds: 


XI  - 

FOR  REGION 
0.00000 

1 

ALPHAl  - 

1 

XI  PRIME 

-  1.00000000 

X2  - 

15.00000 

ALPHA2  - 

16 

GIVEN  X2 

PRIME  -  1.00000000 

X2CALC  - 

15.00000 

CALC  X2 

PRIME  -  1.00000000 

A  -  - . lOOOOOOOOOOOOOOOOOE+01 
B  -  0.100000000000000000E-K)1 
C  -  0 . lOOOOOOOOOOOOOOOOOE+01 


The  user  selects  a  single  region  ending  25  units  from  the  origin  with  an 
ending  cell  size  of  0.5  units: 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
...ENTER  "MENU"  OR  "?"  TO  SEE  MENU... 
.  PLEASE  USE  UPPERCASE. . . 

smM  ts.  :s 


The  program  responds: 


XI  - 

FOR  REGION 
15.00000 

1 

ALPHAl  - 

16 

XI 

PRIME  - 

1.000000000 

X2  - 

25.00000 

ALPHA2  - 

30 

GIVEN  X2 

PRIME  - 

1.000000000 

X2CALC  - 

24.74005 

CALC  X2 

PRIME  - 

0.52722165 

A  -  0.88764562103680U58E+03 
B  -  -.918153961332387552E+03 
C  -  -.183350487A63515010E-01 


The  user  has  completed  mapping  the  x-directlon: 
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CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

.  .  .MAY  BE  ABF..EV  TO  FIRST  3  CHAR.  .  . 
...ENTER  ’.TtNU"  OR  "?"  TO  SEE  MENU... 
. . .PLEASE  USE  UPPERCASE. . 

m 


The  program  responds: 


X-DIRECTION  MAPPING  COMPLETE:  2  REGIONS 


X- 

SPACE 

ALPHA 

X- 

PRIME 

A 

B  C 

FROM 

TO 

FROM 

TO 

FROM 

TO 

0.0000 

15.0000 

1 

16 

1.000 

1.000 

-1.000 

1.000  1.000 

15.0000 

25.0000 

16 

30 

1.000 

0.527 

887.6 

-918.2  -.1834E-01 

The  user  selects  to  map  another  direction: 


MAPPING  IN  THE  X  DIRECTION  IS  COMPLETED 
DO  YOU  WISH  TO  MAP  IN  ANOTHER  DIRECTION  (Y/N)? 

I 


The  user  specifies  which  direction  to  map: 


SPECIFY  MAPPING  DIRECTION  (X  OR  Y) : 

I 


The  user  is  prompted  for  an  initial  distance  from  the  grid  origin  (Y)  and  an 
initial  cell  size  (ALPHA) : 


SPECIFY  INITIAL  Y  DISTANCE  AND  ALPHA 

(CARRIAGE  RETURN  EMPLOYS  DEFAULTS:  Y-O.O  AND  ALPHA-1) 

***  USE  ONLY  INTEGERS  FOR  ALL  ALPHAS  INPUT! ! ! 


The  user  is  prompted  for  an  initial  cell  size  (Y' ) : 


SPECIFY  ASSOCIATED  DERIVATIVE  Y-PRIME: 


The  user  selects  a  single  region  15  inches  in  length  with  a  cell  size  of  1 
inch: 
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CHOOSE  AN  INSTRUCTION  FORM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
...ENTER  "MENU"  OR  "?"  TO  SEE  MENU... 
. . .PLEASE  USE  UPPERCASE. . . 

SINCLE  15.  X, 


Since  the  initial  cell  size  (Y')  was  1  inch,  then  the  cells  for  this  region 
are  a  const  mt  value  of  1  inch.  The  program  responds: 

FOR  REGION  1 

Y1  -  0.00000  ALPHAl  -  1 

Y2  -  15.00000  ALPHA2  -  16 

Y2CALC  -  15.00000 

A  -  - . lOOOOOOOOOOOOOOOOOE+01 
B  -  0 . lOOOOOOOOOOOOOOOOOE+01 
C  -  0 . lOOOOOOOOOOOOOOOOOE+01 


The  user  has  completed  mapping  the  y-direction: 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

. . .ENTER  "MENU"  OR  "?"  TO  SEE  MENU. . . 
. . .PLEASE  USE  UPPERCASE. . . 


The  program  responds: 


Y-DIRECTION  MAPPING  COMPLETE:  1  REGIONS 

REG  Y- SPACE  ALPHA  Y-PRIME  ABC 

FROM  TO  FROM  TO  FROM  TO 

1  0.0000  15.0000  1  16  1.000  1.000  -1.000  1.000  1.000 


MAPPING  IN  THE  Y  DIRECTION  IS  COMPLETED 
DO  YOU  WISH  TO  MAP  IN  ANOTHER  DIRECTION  (Y/N)? 

I 

The  system  responds: 

STOP 

CP:  0.010s,  Wallclock:  70.114s 


***  end  of  CMSGRID  PROCEDURE  *** 


Y1  PRIME  -  1.00000000 

GIVEN  Y2  PRIME  -  1.00000000 

CALC  Y2  PRIME  -  1.00000000 
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Program  output 

46.  Output  of  program  MAPIT  consists  of  a  file  containing  the  XSTRETCH 
and  YSTRETCH  records  used  by  models  WIFM  and  SPH.  These  records  can  be 
directly  added  to  those  models'  input  data  files.  Furthermore,  this  file  can 
be  processed  using  programs  LISTIT  and  DRAWIT,  which  are  discussed  in  the 
following  sections. 
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Program  DRAWIT 


47 .  Program  DRAWIT  Is  an  interactive  program  for  graphically  displaying 
and/or  plotting  the  computational  grid  produced  by  program  MAPIT.  Hence, 
program  MAPIT  must  be  executed  first  to  develop  the  grid  stretching 
coefficients.  In  addition,  bathymetric  data  can  be  plotted  directly  on  the 
computational  grid.  If  such  data  are  available  In  a  computer  file  in  the 
format  shown  below: 


BATHSPEC  FEET  0.0  0.0  -10.0  XY  (9F8.2) 


-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

-10.00 

48 .  Program  DRAWIT  presently  can  generate  graphical  output  for  the 
following  devices: 

a.  Tektronix  4014  terminals,  DEC  VT  series  terminals,  or  compatible 
devices . 

ti.  Hewlett  Packard  DraftMaster  II  drum  plotters  or  compatible  devices. 

49.  A  drum  plotter  Is  typically  used  for  producing  map  overlays.  These 
overlays  are  very  helpful  when  developing  Input  bathymetry/topography  data  set 
for  models  such  as  WIFM.  Presently,  the  map  overlays  can  be  plotted  at  the 
Waterways  Experiment  Station  (WES)  Coastal  Engineering  Research  Center  (CERC) 
or  Information  Technology  Laboratory  (ITL).  The  user  may  wish  to  contact 
their  ADP  coordinator  to  determine  whether  a  plot  file  can  be  plotted  on  in- 
house  devices. 

Program  execution 

50.  The  Interactive  session  begins  by  entering  the  command: 


h2crplcl :  larry$/ti3/Mdk^l«^0/<^ 


The  CHS  responds: 
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W  E 

L  C  0  M  E 
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XXXXX 
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X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

XXXXX 

Return  for 

more . . . 

7cx“»ir7riricwxxi»itwiciciR.  witirTtxicxxxjiciirxifif  xxxiTw  » 

*  CMS  COMPONENTS  * 


*  Options :  * 

*  ★ 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSHODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - - - >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model)  --->  5  * 


*  Exit  CMS  . >  q 


Enter  option  number  . >  | 

The  CMS  responds: 
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Return 

for  more. . 

Enter  option  number  . - - - >  § 
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ie*^rkit**^rk***i[*******■k*■k*k  *kk  ****  kk*****icirkirk**ieirk********irit** 


*  CMSGRID  COMPONENTS  * 

*  MAPIT:  (Stretched/constant  rectangular  * 

*  coordinate  grid  generator)  . >  1  * 

*  * 

*  DRAWIT:  (Graphical  program  to  plot  grids 

* 

*  generated  by  MAPIT)  . >  2  * 

*  * 

*  LISTIT;  (Program  to  print  grid  coordinate 

* 

*  points)  - >  3  * 

*  * 


The  user  Is  prompted  to  select  a  CMSGRID  component: 

Enter  option  number  — . — . •->  1 

The  CMS  responds: 
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Return  for 

more _ 

The  user  is  prompted  for  the  file  name  generated  by  MAPIT  containing  grid 
stretching  coefficients: 

Enter  name  of  the  Input  data  set 

The  user  Is  prompted  for  bathymetric  data  If  they  exist: 
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Do  you  want  to  plot  bathymetric  data  on  the  grid 


The  program  responds: 


CURRENT  PLOT  FEATURE  SUMMARY: 

INDEX  DIRECTION:  - X . Y . 

NO.  OF  GRID  CELLS:  1  TO  29  1  TO  15 

CURRENT  WINDOW:  1  TO  29  1  TO  15 

CURRENT  LENGTH:  26.69(IN)  16.01(IN) 

CURRENT  SCALE:  1.00 

PLOT  CELL  INDICES:  YES 

PLOT  BATHYMETRY:  NO  BATHYMETRY  FILE:  N/A 

FTITLE: 

PRESS  RETURN  TO  CONTINUE  ... 


AVAILABLE  MENU  ITEMS: 


PRINTS  THIS  LIST  OF  INSTRUCTIONS 
ENDS  PROCEDURE 

DECLARES  PLOT  TITLE ... 64  OHAR  OR  LESS 
SELECTS  PLOT  WINDOW 
SELECTS  WHOLE  GRID  FOR  PLOTTING 
SELECTS  DESIRED  PLOTTING  SCALE 
CELL  INDICES  TO  BE  LABELLED 
NO  LABELLING  OF  CELL  INDICES 
BATHYMETRY  VALUES  TO  BE  INDICATED 
. . .  BATHYMETRY  DATA  TO  BE  READ  FROM  FILE: 
BATHYMETRY  VALUES  WILL  NOT  BE  INDICATED 
PRINT  CURRENT  PLOT  FEATURES 
GENERATE  THE  PLOT  (ON  THE  LOCAL 
PLOTFILE) 


MENU 

STOP 

FTITLE  PLTITL 

WINDOW  IXl,  1X2,  lYl,  IY2 

WHOLE 

SCALE  PLSCAL 
INDICES 
NOINDICES 
BATH  BATHFIL 

NOBATH 

SUMMARY 

HARDCOPY 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 
.  . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

.  . .PLEASE  USE  UPPERCASE. . . 


A  selection  Is  made  from  the  available  menu  items  given  in  Table  A- 3. 
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Table  A- 3 


MENU 

STOP 

TITLE 

WINDOW 

WHOLE 

SCALE 

INDICES 

NOINDICES 

BATH 

NOBATH 

SUMMARY 

HARDCOPY 


DRAWIT  Instructions 


_ Patpft _  _ Description _ 

Displays  instruction  commands. 

Terminates  program  execution. 

title  Writes  a  title  of  up  to  64  characters 

on  plot. 


IXl , 1X2 , lYl , 1X2  Defines  a  subgrid  area  to  be  plotted, 

(integers)  1X1  -  minimum  x-axis  cell  index 

1X2  -  maximum  x-axis  cell  index 
lYl  -  minimum  y-axis  cell  index 
1Y2  -  maxlmvun  y-axis  cell  index 

Entire  grid  will  be  plotted. 

Plotting  scale  to  enlarge  or  shrink 
grid  size  on  output  medium. 


Cell  Indices  will  be  printed  on  plot. 

Cell  indices  will  not  be  printed  on 
plot. 

file  name  Bathymetry  values,  supplied  from  file 

listed  in  instruction,  will  be  printed 
on  plot. 

Bathymetry  values  will  not  be  printed. 
Displays  current  plotting  parameters. 
Produces  plot. 
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The  user  selects  not  to  plot  cell  Indices: 


PLOT  CELL  INDICES:  NO 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 

. . .PLEASE  USE  UPPERCASE. . . 

The  user  selects  the  plot  generation  option: 

iH 

END  OF  DISSPLA  10.0  --  1375  VECTORS  IN  1  PLOTS. 

RUN  ON  10/25/90  USING  SERIAL  NUMBER  60  AT  USA  VICKSBURG  CORPS  OF 
ENGINEERS 

PROPRIETARY  SOFTWARE  PRODUCT  OF  ISSCO,  SAN  DIEGO,  CALIF. 

139  VIRTUAL  STORAGE  REFERENCES;  4  READS;  0  WRITES. 


CHOOSE  AN  INSTRUCTION  FROM  THE  MENU: 

. . .MAY  BE  ABBREV  TO  FIRST  3  CHAR. . . 
. . .PLEASE  USE  UPPERCASE. . . 


The  user  selects  to  end  the  DRAWIT  procedure; 


***  PROGRAM  ENDING:  0  PLOTS  GENERATED 

STOP 

CP:  0.080S,  Wallclock:  111.689s 
***  END  OF  CMSPOST  PROCEDURE 


51.  To  display  the  grid  on  a  terminal  screen,  the  user  sets  the 
terminal  to  TEK  4014  using  the  set  up  key  and  enters  the  command: 

The  system  responds: 

ENTER  POST- PROCESSOR  DIRECTIVES 


PLOT  FILE  GENERATED  BY  FID18433 
AT  ISSCO 

ON  OCT  25,  1990  14:27 
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Figure  A-4,  Sample  grid  from  program  DRAWIT 

The  plotting  file  can  be  displayed  on  the  VAX  8800  by  following  the  procedure 
outlined  below.  The  metafile  created  by  the  CRAY  Y-MP  DRAWIT  program  (metfil) 
is  converted  to  a  hexafile  (metafile. hex)  using  the  CRAY  Y-MP  system  utility 
meta2hex  as  follows: 

h2crplcl:larry$ 

**************** 

*  CA-DISSPLA  * 

*  META2HEX  * 

**************** 

Enter  name  of  DISSPLA  metafile  to  be  converted  [popfil]: 

Enter  name  of  output  hex  metafile  [metafile.hex] : 

*  Conversion  complete  -  output  file  is  metafile.hex  * 

STOP 

The  user  then  transfers  the  hexafile  to  the  VAX  8800  as  follows: 

h2crplcl :  larry$  ftp 
Connected  to  wesim3. 

220  wesim3. army. mil  Wollongong  FTP  Server  (Version  5.1)  at  Wed 
Oct  10  10:56T 

Name  (wesim3:h2crplcl) :  Ii2ctple0 
331  Password  required  for  h2crplc0. 

Password:  _ 

230  User  logged  in,  default  directory  $D1SK2: [H2CRPLC0] 

Remote  system  type  is  VMS 
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ftp>  put  .tiox 

200  PORT  Command  OK. 

125  File  transfer  started  correctly 

226  File  transfer  completed  ok 

119481  bytes  sent  1.2  seconds  (97Kbytes/s) 

ftp>  ^t»lt 

221  Goodbye. 

h2crplcl : larry$ 

Connection  closed  to  larry.wes.army.mil 
The  hexaflle  is  then  converted  to  a  metafile  on  the  VAX  8800  using  the  system 
utility  HEX2META  as  follows: 

**************** 

*  CA-DISSPLA  ★ 

*  HEX2META  * 

**************** 


Enter  name  for  output  binary  DISSPLA  metafile  [popfll.dat]: 


Enter  name  of  Input  DISSPLA  hex  metafile  [metaflle.hex] : 


*  Starting  translation  of  DISSPLA  hex  metafile  created  on  10/10/90  at 
10:56:40 

*  CRAY  filename  was  metfll 

*  Metafile  conversion  is  complete  output  file  is  P0PFIL.DAT  * 


The  output  file  can  then  be  transferred  to  the  CERC  VAX  3300  for  plotting  on 
the  drum  plotter  by  invoking  the  command: 

COFf  FB$Z}f3*D8»rna8te 

52.  To  plot  on  the  drum  plotter  located  in  the  CERC  terminal  room,  the 
user  logs  onto  the  terminal  adjacent  to  the  drum  plotter  by  typing: 

C>  iimill  (Inlet,  or  Aeolus) 

The  system  will  prompt  the  user  for  a  VAX  3300  user  name  and  password.  Once 
logged  onto  the  VAX  3300,  the  user  must  create  a  file  called  DRUMFLT.FOR  as 
given  below: 

CALL  HP75 

CALL  METNAM( ' PICTUR' ,6) 

CALL  DISPOP(l) 

STOP 

END 

To  compile  and  link  the  DRUMPLT  file,  the  user  types: 

$  tmtsw 

To  produce  an  actual  size  plot,  type: 

IKSmI:  V 
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Program  LISTIT 


53.  Program  LISTIT  produces  a  file  containing  a  listing  of  the 
stretched  rectilinear  coordinates  computed  from  the  stretching  coefficients 
generated  by  program  MAPIT.  Therefore,  program  MAPIT  must  be  executed  first, 
and  Its  output  file  stored  as  an  Indirect  access  file  before  attempting  to  use 
program  LISTIT. 

Program  execution 

54.  Program  LISTIT  is  executed  Interactively  by  the  commands: 
h2crplcl :  larry$||||^|^^g^||pip 

The  CMS  responds: 


WELCOME 

TO.. 

• 

XXXXX  X 

X 

XXXXX 

X  X  XX 

XX 

X  X 

X  X  X  X  X 

X 

X  XX 

X 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

X 

XXXXX 

Return  for 

more . . . 
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* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


CMS  COMPONENTS 

. -  i  4  i  v  - -  -  -  .  -  «  -  -  S * 

Options:  ♦ 

* 

CMSGRID  (Maps,  plots,  and  lists  the  nuoeirical  gr^  i  * 

CMSMODEL  (Compiles,  links,  loads,  and  executes  e 

ntunerical  models)  2  * 

* 

CMSPOST  (Plots  and  lists  model  outputs)  -- — - - .->  3  * 

* 

CMSUTIL  (Additional  "utility"  prograns)  . - . 4  * 

CMSSAMP  (Sample  input  and  output  files  for  each  model  <■>•«>  5  * 

* 

Exit  CMS  . . . . . — - * - - - ..>  q  * 


Enter  option  number  . . .  —  . . >  || 

The  CMS  responds: 


CCCC 

M 

M 

SSSS 

GGGG 

RRRRR 

I 

DDDDD 

c  c 

MM 

MM 

S  S 

G  G 

R  R 

I 

D  D 

c 

M  H 

M  M 

s 

G 

R  R 

I 

D  D 

c 

M  M  M 

SSSS 

G 

RRRRR 

I 

D  D 

c 

M 

M 

s 

G  GGG 

R  R 

I 

D  D 

c  c 

M 

M 

s  s 

G  G 

R  R 

I 

0  D 

CCCC 

M 

M 

SSSS 

GGGG 

R  R 

I 

DDDDD 

Return  for  more . . 
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*************************************************************+******* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options ;  '* 

*  * 

*  On-Line  Help  - - - - >  1  * 

*  * 

*  Enter  CMSGRID  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . - . >  3  * 

*  * 


********************************************************************* 


Enter  option  number 


************************************************************* 


*  CMSGRID  COMPONENTS  * 

************************************************************* 

*  MAPIT:  (Stretched/constant  rectangular  * 

*  coordinate  grid  generator)  . ->  1  * 

*  * 

*  DRAWIT:  (Graphical  program  to  plot  grids  * 

*  generated  by  MAPIT)  . . >  2  * 

*  * 

*  LISTIT:  (Program  to  print  grid  coordinate  * 

*  points)  . . >  3  * 

*  * 

*  EXIT:  (Terminate  computer  session)  . >  4  * 


************************************************************* 


The  user  is  prompted  to  select  a  CMSGRID  component: 


Enter  option  number 


>  3 


The  CMS  responds: 
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X 

X 

xxxxx 

XXXXXXX 

X 

XXXXXXX 

X 

X 

X  X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

xxxxx 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X  X 

X 

X 

X 

xxxxxxxx 

X 

XXXXX 

X 

X 

X 

Return  for 

more . . . 

Enter  name  of  the  Input  data  set 
Enter  name  of  the  output  file  mock.lst: 
The  system  responds; 


. . .NORMAL  TERMINATION. . .PROCESSING  FINISHED 
STOP 

CP:  0.019S,  Wallclock;  0.028s,  10.9%  of  6-CPU  Machine 

***  END  OF  CMSPOST  PROCEDURE 


Program  LISTIT  produces  an  output  file  containing  the  grid  coordinates. 
"FACE"  indicates  the  location  of  the  edge  of  a  grid  cell  and  "CENTER" 
indicates  the  location  of  the  grid  cell  center.  Output  file  mock. 1st  is 
displayed  as  follows; 
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h2crplcl :  larry$  {y( 


*  *  SUMMARY  OF  MAPPED  REGIONS : 


REGION  NO.  CELL  ALPHA  ABC 


XREGION 

1 

FROM 

1 

TO 

30 

FROM 

1. 

TO 

31. 

-1.00000 

1 . 00000 

1.00000 

YREGION 

1 

1 

15 

1. 

16. 

-1.00000 

1.00000 

1 . 00000 

***  SUMMARY  OF  X- COORDINATES: 
CELL 


INDEX 

ALPHA 

FEATURE 

X 

X' 

X" 

1.0 

FACE: 

0.0000000000 

1.0000000000 

0.0000000000 

1 

1.5 

CENTER: 

0.5000000000 

1 . 0000000000 

0.0000000000 

2.0 

FACE: 

1.0000000000 

1 . 0000000000 

0.0000000000 

2 

2.5 

CENTER: 

1.5000000000 

1.0000000000 

0.0000000000 

3.0 

FACE: 

2.0000000000 

1 . 0000000000 

0.0000000000 

3 

3.5 

CENTER: 

2.5000000000 

1.0000000000 

0.0000000000 

4.0 

FACE: 

3.0000000000 

1.0000000000 

0.0000000000 

4 

4.5 

CENTER: 

3.5000000000 

1.0000000000 

0.0000000000 

5.0 

FACE: 

4.0000000000 

1.0000000000 

0.0000000000 

5 

5.5 

CENTER: 

4.5000000000 

1.0000000000 

0.0000000000 

6.0 

FACE: 

5.0000000000 

1 . 0000000000 

0.0000000000 

6 

6.5 

CENTER: 

5 . 5000000000 

1.0000000000 

0.0000000000 

7.0 

FACE: 

6.0000000000 

1.0000000000 

0 . 0000000000 

7 

7.5 

CENTER: 

6 . 5000000000 

1.0000000000 

0.0000000000 

8.0 

FACE: 

7.0000000000 

1 . 0000000000 

0.0000000000 

8 

8.5 

CENTER: 

7 . 5000000000 

1 . 0000000000 

0.0000000000 

9.0 

FACE: 

8.0000000000 

1.0000000000 

0.0000000000 

9 

9.5 

CENTER: 

8 . 5000000000 

1 . 0000000000 

0.0000000000 

REFERENCE 


EM  1110-2-1412.  1986.  "Engineering  and  Design  Storm  Surge  Analysis," 

Department  of  the  Army  Corps  of  Engineers,  Office  of  the  Chief  of  Engineers. 
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APPENDIX  B:  CMSUTIL 


B-1 


Introduction 


1.  CMSUTIL  Is  the  software  package  In  the  Coastal  Model  System  (CHS) 
that  provides  the  user  access  to  programs  that  supplement  the  CMS  models . 
Presently,  the  following  programs  reside  In  this  package; 

TIDEGEN  Generates  tidal  elevation  time-history  data  at 

select  locations  from  tidal  harmonic 
constituents . 

TIDECON  Synthesizes  tidal  harmonic  constituents  from 

a  time  series  of  hourly  tidal  elevations. 

2.  Descriptions  of  each  program,  Including  data  requirements  and 
execution  procedures,  are  provided  In  the  following  sections. 

Program  TIDEGEN 

3.  Program  TIDEGEN  generates  a  time  series  of  tidal  elevations  from 
tidal  harmonic  constituents.  The  mathematical  procedures  used  to  produce  the 
data  are  described  in  Schureman*.  This  program  can  simultaneously  process 
records  for  a  maximum  of  60  gage  locations.  The  following  data  are  required 
for  each  gage: 

a.  Longitude  of  the  gage. 

fe.  Constituents  that  are  applicable  to  that  gage  location. 

£.  Amplitudes  and  epochs  corresponding  to  each  constituent  selected 
In  Item  b. 

Starting  date  and  local  time  at  the  specified  longitude. 

4.  The  National  Ocean  Service  (NOS)  provides  amplitude  and  epoch  data 
for  different  tidal  constituents  at  US  coastal  locations.  To  facilitate  the 
use  of  NOS  Information,  program  TIDEGEN  uses  the  same  constituent  names  as 
NOS.  Table  B-1  presents  a  list  of  those  constituents  available  for  use  In 
this  program. 

5.  The  output  of  TIDEGEN  consists  of  a  file  containing  the  computed 
water  surface  elevations  and  an  optional  printout  of  the  constituents.  Model 
WIFM  contains  TIDEGEN  as  a  component  to  compute  the  tide  data  internally 


*  P.  Schureman,  1958,  "Manual  of  Harmonic  Analysis  and  Prediction  of  Tides," 
Special  Publication  No.  98,  US  Coast  and  Geodetic  Survey,  Department  of 
Commerce,  Washington,  DC. 
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during  the  course  of  a  simulation.  However,  it  is  suggested  that  the  user 
reproduce  the  data  with  TIDEGEN  before  running  UIFM  to  check  the  accuracy  of 
the  program  output.  Tide  elevations  may  be  plotted  using  program  HYDPLT  in 
package  CMSPOST  (Appendix  C) . 

6.  The  first  tidal  elevation  in  the  output  file  corresponds  to  the 
starting  date  and  time.  Time  intervals  between  subsequent  tidal  elevations 
are  constant;  however,  the  time  interval  depends  on  the  total  length  of  time 
for  which  output  data  are  generated.  Table  B-2  presents  the  time  intervals  at 
which  the  output  data  are  generated. 

Data  requirements 

7.  An  instruction  file  containing  certain  input  data  records  must  be 
created  before  executing  the  TIDEGEN  program  (see  Table  B-3).  Each 
instruction  or  data  record  in  the  file  must  begin  with  a  record  identifier 
starting  in  column  1,  which  identifies  the  type  of  data.  For  example,  record 
identifier  EPCHl  is  for  the  epoch  of  each  constituent  associated  with  gage  1, 
AMPLl  is  for  the  amplitude  of  each  constituent  associated  with  gage  1,  and  so 
forth.  Table  B-3  presents  the  Instruction  file  records  applicable  to  this 
program.  Data  to  the  right  of  the  record  identifiers  are  read  format- free. 
These  data  must  be  separated  by  at  least  one  blank  column  (commas  cannot  be 
used).  Note  the  "Type"  designations  [R]  and  [0]  in  column  1  of  Table  B-3 
indicate  required  and  optional  records,  respectively. 

8.  The  TITLE  record  gives  the  simulation  a  general  title  that  can  be 
used  by  the  plotting  program,  HYDPLT.  The  TIMES  record  specifies  the  starting 
time  for  computing  tidal  elevation  data.  Parameters  contained  on  this  record 
Include  the  year,  month,  day,  and  hour  for  beginning  the  simulation  and  the 
length  of  the  simulation,  in  hours.  The  GNAM_  record  is  used  to  give  a 
reference  name  to  a  particular  time  series,  or  gage.  (The  _  is  explained  in 
the  following  paragraph.) 

9.  Each  gage  requires  one  set  of  GNAM_,  L0NG_,  CNST_,  AMPL_,  and  EPCH_ 
commands,  entered  in  the  order  specified  in  Table  B-3.  The  record  Identifiers 
describing  the  gage,  constituent,  amplitude,  epoch,  and  longitude  data  require 
a  qualifier  or  nvunber  that  corresponds  to  the  gage  nvimber.  This  qualifier 
must  be  immediately  adjacent  to  the  record  identifier.  The  first  gage  has  the 
qualifier  "1,"  the  second  gage  has  the  qualifier  "2,"  and  so  forth. 

10.  The  L0NG_  provides  the  longitude  (in  degrees)  west  of  the  Greenwich 
meridian  for  the  specific  gage.  If  the  command  LONGl  is  omitted,  the  time 
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Table  B-1 


List  of  Available  Constituents 


Reference  NOS 

Number  Name  _ Description 


1 

M2 

Semidiurnal 

2 

S2 

Semidiurnal 

3 

N2 

Semidiurnal 

4 

K1 

Diurnal 

5 

M4 

Shallow-water 

6 

01 

Diurnal 

7 

M6 

Shallow-water 

8 

MK3 

Shallow-water 

9 

S4 

Shallow-water 

10 

MN4 

Shallow-water 

11 

NU2 

Semidiurnal 

12 

S6 

Shallow-water 

13 

MU2 

Semidiurnal 

14 

2N2 

Semidiurnal 

15 

001 

Diurnal 

16 

LAMBDA2 

Semidiurnal 

17 

SI 

Diurnal 

18 

Ml 

Diurnal 

19 

J1 

Diurnal 

20 

MM 

Long-period 

21 

SSA 

Long-period 

22 

SA 

Long-period 

23 

MSF 

Long-period 

24 

MS 

Long-period 

25 

RHOl 

Diurnal 

26 

Q1 

Diurnal 

27 

T2 

Semidiurnal 

28 

R2 

Diurnal 

29 

2Q1 

Diurnal 

30 

PI 

Diurnal 

31 

2SM2 

Shallow-water 

32 

M3 

Terdiumal 

33 

L2 

Semidiurnal 

34 

2MK3 

Shallow -water 

35 

K2 

Semidiurnal 

36 

M8 

Shallow -water 

37 

MS4 

Shallow-water 

quarter  diurnal 

sixth  diurnal 
terdiumal 
quarter  diurnal 
quarter  diurnal 

sixth  diurnal 


semidiurnal 


terdiumal 

eight  diurnal 
quarter  diurnal 


Table  B-2 

TIDEGEN  Output  Data  Time  Intervals 


Simulation  Length 

Time  Interval 

hr 

min 

< 

1.5 

0.5 

1.5 

- 

3.0 

1.0 

3.0 

- 

7.0 

2.0 

7.0 

- 

15.0 

5.0 

15.0 

- 

25.0 

10.0 

25.0 

- 

45.0 

15.0 

45.0 

- 

90.0 

30.0 

90.0 

• 

60.0 

specified  in  command  TTMES  would  default  to  Greenwich  time.  For  each  selected 
constituent  for  a  particular  gage,  the  user  must  specify  a  corresponding 
amplitude  using  record  AMPL_,  For  example,  if  GNAMl  has  constituents  H2  and 
S2,  then  record  AMPLl  would  contain  two  amplitudes,  one  corresponding  to 
constituent  M2  and  the  other  corresponding  to  S2.  Similarly,  the  epoch  is 
provided  for  each  constituent  selected  for  a  particular  gage  using  record 
EPCH_. 

11.  Constituents  are  designated  on  the  CNST_  record  by  their  reference 
number,  or  index  (see  Table  B-1)  rather  than  by  their  names.  However,  if  all 
37  constituents  are  desired,  the  user  may  enter  "ALL”  instead  of  listing  all 
of  the  reference  numbers.  Also,  if  some  of  the  reference  numbers  are 
consecutive,  the  user  can  list  the  first  number,  immediately  followed  by  a 
hyphen,  then  the  last  reference  number  (e.g. ,  5-9  would  include  constituents  5 
through  9  from  Table  B-1). 
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CARDID  Data  Default  _ Description _ 

TITLE  title  TITLEl  General  plot  title.  Title  size  is  64  characters. 
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12.  The  following  example  illustrates  the  structure  of  the  Instruction 

file: 


TITLE 

EXAMPLE  INSTRUCTION  FILE 

TIMES 

1987  2  14  12  36 

GAGEl 

GAGE  NO.  1 

LONGl 

135.0 

CNSTl 

1  3 

AMPLl 

2.0  0.5 

EPCHl 

35.0  90.0 

GAGE2 

GAGE  NO.  2 

LONG2 

135.2 

CNST2 

3-5 

AMPL2 

0.25  0.10  0.05 

EPCH2 

15.0  5.0  45.0 

13.  For  this  example,  two  tidal  elevation  time -histories  will  be 
generated.  The  starting  date  and  time  for  each  gage  is  12  noon  on  14  February 
1987  (local  time),  and  data  will  be  produced,  at  10-min  intervals,  for  the  36- 
hr  record  length. 

14.  Gage  no.  1  is  located  135.0  deg  west  of  the  Greenwich  meridian 
(i.e.,  command  LONGl) .  Constituents  M2  and  N2,  selected  with  command  CNSTl 
(see  Table  B-1)  are  used  to  generate  the  tidal  elevation  time-history. 
Constituent  M2  has  an  amplitude  of  2.0  ft  and  an  epoch  of  35.0  deg. 

Constituent  N2  has  an  amplitude  and  epoch  of  0.5  ft  and  90.0  deg, 
respectively. 

15.  Three  constituents  are  used  to  generate  the  tidal  elevation  time- 
history  for  the  second  gage.  These  constituents  are  N2,  Kl,  and  M4. 

Amplitudes  and  epochs  are  assigned  to  their  respective  constituents  in  the 
same  fashion  as  for  gage  no.  1. 

Program  execution 

16.  After  creating  and  saving  the  Instruction  file,  the  user  enters  the 
following  interactive  command  at  the  system  prompt: 


h2crplcl :  larry$/tt3/M(^l!:|^t«9/ai* 
system  prompt  user  entry 


It  should  be  noted  that  user  entries  are  shown  as  shaded,  and  CMS  response 
"screens"  are  shaded  boxes. 

The  CMS  responds: 
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C  M  S  CtMPONENTS 

Options: 

CHSGRID  (Maps,  plots,  and  lists  the  numerical  grid) 

CMSMODEL  (Compiles,  links,  loads,  and  executes 

numerical  models)  i--- . . 


CMSPOST  (Plots  and  lists  model  outputs)  . . 

CMSUTIL  (Additional  "utility"  programs)  . . . 

CMSSAMP  (Sample  Input  and  output  files  for  each  model 
Exit  CMS  .  . . . . 


-> 
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To  enter  CMSUTIL,  the  user  enters  a  value  of  4; 

Enter  option  number  - >  || 

The  CMS  responds: 
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Return  for  more... 


Enter  option  number  . --->  § 


CMSUTIL  MENU 


TIDEGEN  Generates  a  time  series  of  tidal  elevations 
from  harmonic  and  tidal  constituents.  - > 


* 

* 

* 

* 

*  TIDECON  Synthesizes  harmonic  constituents  from  time 

*  series  of  hourly  tidal  elevation  data.  - > 

* 

* 

* 


* 
* 

1  * 

* 
* 

2  * 

* 

3  * 

* 

**^r^rk•k******•k*****■k^k******^rk^rk*1t^e^rk*^r^^***^r^rk**it**^rk^r^rk*****•k*^lrk^c^r^rk 


EXIT 


To  execute  program  TIDEGEN,  the  user  enters  a  value  of  1; 

Enter  option  number  - - >  1 

The  CMS  responds: 
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Return  for 

more _ 

Enter  the  name  of  the  instruction  file: 

The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames. 
For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  file. 

Enter  the  name  of  the  output  file  containing  water  surface  elevations: 

Constituent  print-out  desired?  ^ 

Enter  the  name  of  the  constituent  output  file: 

The  CMS  submits  a  batch  job  to  the  CEIAY  Y-MP  and  the  system  responds: 

iiwruiit:;  submitted :  to  <ia<ru«. 

The  user  enters  a  3  to  terminate  the  CNSUTIL  session  and  return  to  the  main 
menu. 

PrpgraiB 

17.  Program  TIDEGEN' s  output  file  containing  the  time  series  of  tidal 
elevations  for  each  gage  can  be  printed  for  inspection  of  the  values ,  or  it 
can  be  used  as  direct  input  to  models  VIFM  and  CLHYD  or  the  plotting  program 
HYDPLT  in  package  CMSPOST. 
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*****Slr*************************ilhlr'<HrilHr**'*********j>r*<:************'jlr<rjlr<r 

*  CMSUTILMENU  * 


* 

* 

* 

* 

* 

* 

* 

* 

* 


TIDEGEN  Generates  a  time  series  of  tidal  elevations 
from  harmonic  and  tidal  constituents, 

TIDECON  Synthesizes  harmonic  constituents  from  time 
series  of  hourly  tidal  elevation  data.  - > 


EXIT 


-->  3 


* 

* 

* 

* 

* 

* 

* 

* 

* 


Program  TIDECON 

18.  Program  TIDECON  synthesizes  harmonic  constituents  from  a  time 
series  of  hourly  tidal  elevation  data.  This  program  requires  the  following 
data: 

S.  Time  series  of  tidal  elevation  data  in  the  format  used  by  the 
National  Ocean  Service  (NOS)  (see  Table  B-4) . 

b.  Longitude  of  the  gage. 

Const ituent(s)  that  are  desired. 

d.  Starting  date  of  the  tide  data.  Starting  time  of  data  must  be 
at  midnight  (HR  0) . 

19.  Tide  data  must  be  free  of  gaps,  spikes,  and  other  eirors  in  order 
to  compute  accurate  constituents.  No  error  correction  or  data  reconstruction 
features  exist  in  this  program.  Furthermore,  the  tidal  elevation  time-history 
data  set  length  required  varies  from  constituent  to  constituent.  A  minimum  of 
30  days  of  continuous  hourly  data  are  needed  to  resolve  lunar  constituents 
(for  example,  H2) .  However,  some  longer  period  constituents  (which  usually 
have  a  relatively  small  effect  on  the  total  tidal  elevation)  may  require  as 
many  as  19  years  of  continuous  hourly  data  to  obtain  accurate  results.  Hence, 
the  user  should  plot  the  time-history  data  generated  using  the  computed 
constituents  to  check  the  accuracy  of  program  TIDECON  output.  (See  program 
HYDPLT  in  package  CMSPOST  (Appendix  C)  to  plot  time -history  data.) 

20.  Output  consists  of  four  files  containing:  (1)  original  gage  data, 
(2)  constituent  data,  (3)  synthesized  gage  data,  and  (4)  residual  difference 
between  original  and  S3mtheslzed  gage  data.  Items  (1),  (3),  and  (4)  are 
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tion  File  Commands  for  Program  TIDECON 


25.  Time  series  Input  data  must  be  In  the  format  used  by  the  NOS  Tidal 

Evaluation  Group  (Table  B-4) .  The  following  requirements  must  also  be  met: 

The  first  tide  record  must  begin  at  midni^t  (HR  0)  of  the  date 
specified  in  the  Instruction  file.  If  the  user's  data  begin  at 
a  time  other  than  midnight,  then  the  time  series  should  be 
truncated  to  begin  at  midnight  of  the  following  day. 

k-  Each  record  must  contain  12  hourly  values,  with  the  flrdt 

record  starting  at  hour  0,  the  second  record  starting  at  hour 
13,  the  third  record  starting  at  hour  0  of  the  second  (Lk/,  etc. 

£.  Tidal  heights  are  entered  as  integers  and  measured  in 
hundredths  of  a  foot.  (For  example,  the  value  "1247" 
translates  to  12.47  ft.) 

26.  This  program  processes  only  the  elevation  data  listed  in  coltunns  33 
through  80  of  the  time  series  data  file.  Columns  1  through  32  are  for 
optional  documenting  of  the  data  set,  and  data  in  these  columns  are  not  used 
by  the  program. 

27.  The  following  example  illustrates  the  structure  of  an  instruction 

file: 


FILES 

MYDAT 

TIMES 

1987  2  15 

LONG 

135.0 

CNST 

13  6-8 

TITLE 

EXAMPLE  INSTRUCTION  FILE 

28.  In  this  example,  tidal  elevation  time-history  data  have  a  starting 
date  of  15  February  1987.  The  starting  time,  specified  in  the  NOS  data  set, 
must  be  at  midnight  (0  hr).  The  time-history  data  will  be  analyzed  to  derive 
the  amplitudes  and  epochs  for  the  five  constituents  listed  in  command  CNST. 
These  constituents  are  M2,  N2,  01,  M6,  and  MK3  (see  Table  B-1). 

Program  execution 

29.  After  creating  and  saving  the  instruction  file,  enter  the  following 
interactive  commands  to  execute  the  program: 

h2crplcl :  larry$gpi9P||9 

The  CMS  responds: 


B-15 


V  E 

L  C  0  M  E 

TO.. 

• 

xxxxx 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

xxxxx 

X 

Return  for 

X 

more . . . 

xxxxx 

*  .  CMS  COMPONENTS  * 

•S.  ^ 


*  Options:  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model)  --->  5  * 

*  '  * 

♦  Exit  CMS  . >  q  * 


To  enter  CMSUTIL,  the  user  enters  a  value  of  4: 


Enter  option  number 


The  CMS  responds: 


■>  i 
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Enter  option  number 


>  I 
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*  CMSUTILMENU  * 
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* 

* 

* 
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TIDEGEN  Generates  a  time  series  of  tidal  elevations 
from  harmonic  and  tidal  constituents.  - > 

TIDECON  Synthesizes  harmonic  constituents  from  time 
series  of  hourly  tidal  elevation  data.  - > 


EXIT 


. > 


* 

* 

* 

* 

* 

* 

* 

* 

* 


******************************************************************* 


To  execute  program  TIDECON,  the  user  enters  a  value  of  2: 

Enter  option  number  - - - >  i 

The  CMS  responds: 
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Return  for  more . . . 

Enter  the  name  of  the  instruction  file 


Again,  the  user  can  choose  any  meaningful  naming  convention  when  selecting 
filenames. 

Enter  the  name  of  the  input  file  containing  time  series  data 
Enter  the  name  of  the  time-history  and  constituent  output  file 
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The  CMS  submits  a  batch  Job  to  the  CRAY  Y-MP  and  the  system  responds: 


m 


The  user  enters  3  to  terminate  the  CMSUTIL  session  and  return  to  the  main 


30.  Program  TIDECON's  output  file  may  be  printed  for  inspection  of 
values.  Output  files  containing  time -histories  of  tide  elevations  can  be  used 
as  direct  input  to  the  plotting  program  HYDPLT  in  package  CNSPOST.  The  act\ial 
tidal  constituents  are  output  in  the  same  file. 
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APPENDIX  C:  CMSPOST 


C-1 


Introduction 


1.  CMSPOST  is  the  post-processing  package  in  the  Coastal  Modeling 
System  (CMS)  for  displaying  output  generated  by  models.  CMSPOST's  graphical 
and  tabular  output  will  help  the  user  in  analyzing  model  results.  Model 
output  is  directly  read  into  this  package;  however,  in  most  cases  an 
instruction  file  containing  information  to  generate  the  plots  must  be  created 
by  the  user.  CMSPOST  can  also  process  data  not  generated  by  the  models;  but 
data  must  be  in  the  format  required  by  the  programs.  The  types  of  graphics 
that  can  be  produced  are; 

a.  Time-histories  of  water  surface  elevations,  water  and  wind 
velocities,  and  pressure  at  discrete  locations. 

b.  Vector  maps,  or  "snapshots,"  of  water  or  wind  velocities  at  a 
specified  time  in  the  simulation. 

c.  Profile  plots  showing  the  spatial  distribution  of  a  variable. 

d.  Wave  ray  plots  for  displaying  RCPWAVE  output  only. 

In  addition,  models  SHALWV  and  STWAVE  have  their  own  graphics  options  (see 
Chapters  7  and  8) . 

2.  All  programs  are  written  in  FORTRAN  77,  and  graphics  are  produced 
using  DISSPLA™  software.  Graphic  output  structure  requires  use  of  Tektronix 
4014  or  compatible  terminals. 

3.  The  programs  contained  in  CMSPOST  are  described  in  Table  C-1.  Refer 
to  records  RECGAGE,  RECSNAPS,  PLOTREC,  XRECRANG,  and  YRECRANG  in  the  model 
documentation  for  creating  and  saving  data  used  in  CMSPOST. 

Data  Requirements 

In.atruction  file  for  time-historv  programs 

4.  The  instruction  file  contains  commands  describing  how  the  data 
set(s)  are  to  be  processed.  Each  line  in  the  file  must  begin  with  a  record 
identifier  that  signifies  an  operation.  The  record  identifier  must  begin  in 
column  1  of  the  line;  the  program  will  not  right- justify  these  variables.  The 
data  entered  after  the  record  identifier,  unless  otherwise  noted,  are  read 
free  format  and  must  be  separated  by  at  least  one  blank  column  (commas  can  not 
be  used).  All  instruction  file  commands  for  the  time-history  programs  are 
listed  in  Table  C'2. 


C-2 


Table  C-1 

Post-Processing  Programs 


Program 

Descriotion 

Annlicable  to 

HYDPLT 

Produces  time -series  plots  of  water  surface  fluct¬ 
uations,  wind  and  water  velocities,  pressure  head 
and  discharge. 

SPH,  WIFM, 
CLHYD 

HYDLST 

Prints  time -series  of  water  surface  fluctuations 
water  velocities,  wind  velocities,  and  angles, 
pressure  head,  and  water  discharge. 

SPH,  WIFM, 
CLHYD 

HYDADD 

Concatenates  time -history  records  from  successive 
runs  of  a  model  for  processing  by  HYDLST  or  HYDPLT. 

SPH,  WIFM, 
CLHYD 

SNAPVEC 

Produces  vector  plots  of  water  and  wind  velocity 
fields . 

SPH,  WIFM, 
CLHYD 

SNAPLST 

Prints  field  arrays  described  in  SNAPVEC.  Vectors 
may  be  printed  as  either  x-y  components  or  as 
magnitude  and  direction. 

SPH,  WIFM, 
CLHYD 

PROFPLT 

Profile  plot  of  specified  field  variable. 

SPH,  WIFM, 
CLHYD, 

RCPWAVE 

RAYPLT 

Wave  ray  plots  from  model  RCPWAVE. 

RCPWAVE 

5.  Programs  that  create  time -history  plots  and  tables  can  process  a 
maximum  of  four  separate  data  sets  simultaneously.  Furthermore,  data  from  one 
file  can  be  plotted  with  data  from  another  on  the  same  graph. 

6.  All  commands,  categorized  as  format  [F]  or  select  [S]  commands,  may 
appear  in  any  order.  Format  commands  refer  to  operations  that  modify  the 
default  parameters  controlling  the  format  of  the  plots  or  tables.  For 
example,  the  type  of  modifications  that  can  be  made  include  changing  axes 
titles,  or  the  minimum,  maximum,  and  increment  values  used  to  plot  the 
independent  variable. 

7.  Select  commands  are  used  to  select  the  data  set,  type  of  data,  and 
the  time-history  to  be  plotted  or  tabularized.  The  first  letter  in  the  record 
identifier  for  select  commands  represents  the  type  of  data  (e.g.,  T  -  water 
surface  level  data)  that  is  to  be  processed.  Immediately  adjacent  to  the 
record  identifier  is  a  qualifier  that  identifies  which  file  is  to  be  used. 
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Table  C-2 

Instruction  File  Commands  for  Time -History  Plots 


•  <4 

O  •  TV 

ro 

g 

VI  VI 

4J 

CM  d  f-l 

O 

3 

C  <4 

c 

^-1 

1— 1 

g 

4)  T3 

a> 

CO  •*-!  (0 

•f-4 

O 

♦fH 

e 

g 

.H  <4-1  s-l 

t|-l 

X 

41  4) 

0) 

r-4 

<0 

<t 

14  X 

Li 

0)  0)  0) 

d 

s: 

VO 

O  VI 

O 

to 

M  00  N 

00 

4J 

B 

c 

t3 

•H 

•H  t0  'f-l 

CO 

d 

to 

•H  e 

•d 

C 

to  OO  CO 

OO 

d 

(0 

0) 

«H 

o 

CO  • 

<6 

0) 

X 

M 

• 

00 

T3  Vl 

<d 

•d 

4J  *0 

N 

d  a  a> 

a 

<>3 

o 

4J 

(0 

4) 

C  ivi 

C 

•H  0) 

M 

rH  O  <H 

o 

c4 

CL 

N 

<4 

to 

<0 

a  > 

vl 

CO 

4->  Ll  4J 

Ll 

u 

e 

4«-| 

•o 

■u 

*H  (0 

44 

•H  4^  vH 

<4-1 

4) 

u 

Li 

to 

U  4) 

•H 

D 

f-l  to 

e 

<D 

H  _  H 

c 

o 

4> 

VI  VI 

g 

•w 

44 

f-H 

-d 

o 

4) 

<4-1 

CL 

4) 

•H  4l 

♦H 

a 

00  4J 

1-4 

D 

0) 

d 

•H 

■P 

r-4 

e  •-< 

•w 

P  O 

•H 

•  ff-l  • 

•r4 

c4 

4J 

•0 

4J 

44  B 

i-H 

•H  C 

bO 

H 

4)  r-^  0) 

f— 1 

o 

O 

V4 

4) 

•r4 

t-l  o 

OO 

D 

B 

r-l  CLi-l 

CL 

•H 

O 

O 

U 

H 

r—i 

c 

00 

4J  <4-1 

44 

L>  P4  4J 

CL 

u 

CL 

4J 

bO  4) 

•r4 

0 

O  fl 

vl  • 

• 

-4  3  .,4 

d 

c 

4) 

O 

c  u 

•H 

f-H 

Vl  Vl 

a> 

VI  (I)  VI 

CO 

CO 

o 

Lf 

• 

44 

4J 

CL  TO 

o  o 

4) 

4J 

p> 

0) 

VI  41 

O 

<L) 

0) 

.-4  VI 

li 

W  W  0) 

CO 

Q 

c 

»— 4 

VI  14 

1-^ 

O 

O  Ll 

p.  U 

•fH 

44  VI  44 

li 

U 

•H 

u 

4-1 

O  <4 

CL 

rH 

Li  O 

4] 

l> 

X  •:!  X 

fH 

jC 

fH 

CL 

B  B 

4)  44 

«  B  41 

C 

Pu 

(0 

o. 

a  M 

CO 

(4  bO 

bO 

CO 

E3 

P 

4J 

4J 

<d 

4) 

•r^ 

CO 

U  44 

P  B 

Tl 

O 

U 

4)  B 

X 

•H 

41 

(d  o 

X 

VI  4 

O 

• 

bO 

O  • 

e  .-1 

(0 

X 

Vl  W 

43  .r4 

<0 

• 

44  •  4) 

• 

to 

04 

f-l  M 

44  <4 

• 

to 

P.44 

O  VI 

CO 

U  W  J3 

CO 

(Q 

c 

<4-1 

O.  VI 

VI  > 

0 

4J 

M  41 

c 

Ll 

O  Vl 

L4 

4) 

•H 

CO 

O 

4) 

o 

c 

>s 

■O  4> 

44  N 

o 

a> 

r4  41  41 

d 

C4 

4) 

rH  VI 

U 

f-i 

0) 

4J 

B  M 

■O  ..4 

•«-( 

u 

tt  VI  14 

li 

10 

CO 

O 

w 

4>  U 

44  1-4 

4^ 

a 

•H 

41  B 

1-4 

iJ 

o 

>03 

o 

U 

4> 

0) 

• 

vi  <d 

44  B 

<0 

a> 

O 

W 

41  41 

<0 

CO 

41  10 

d 

4) 

O 

•o 

ja 

«  Vl 

U  « 

• 

> 

o 

•O  w 

bO  B 

> 

Ll 

■O  Vl  n 

L4 

fS 

O 

o 

C  41 

41  44 

4J 

O 

O 

B  4) 

B  Vl 

0) 

<0 

B  Id  4) 

<0 

4) 

V4 

§ 

•w 

4)  ^ 

CV  4) 

O 

C 

0) 

44  14 

41  O 

r-l  X 

44  J3  14  J3 

O 

a 

o 

U  U 

(A  O 

<0 

U) 

H-l 

> 

S  04 

P.  B 

U 

u 

?  U  Pi 

O 

I 


■o 

lU 

3 

C 


c 

o 

o 


CM 

( 

CJ 

<u 

Xt 

cd 

H 


(0 

d) 

u 

to  P 

V4 

CO 

d) 

d) 

CO  O 

4)  0) 

d> 

<M 

o 

o 

bO 

d>  4J 

l4  ^ 

o 

d)  bO 

C 

d3 

P 

4-1 

•H 

p  € 

CO 

Cm 

N  CQ 

0) 

O 

•o 

3 

4J  *0 

1-1  3 

C 

•M 

CM 

•H  bO 

P. 

0) 

C4 

•  P 

f-i  0) 

o  c 

o 

fM 

U) 

0) 

X 

40 

14 

CO 

C^  o 

o 

•H 

cO 

M 

£ 

Vt 

p 

cd 

X 

C  d) 

O  P 

.-t  4) 

4J 

-3  5, 

0) 

d)  o 

bO 

bO 

O  rH 

rH  d> 

4)  f-4 

CO 

•O  O' 

0) 

rH  VJ 

P 

o 

CO 

4) 

*^4 

d)  V4 

>  f4 

> 

d) 

,c 

iJ  <4-1 

f-i 

4J 

Q> 

B 

o 

4J  4H 

>  d> 

44 

0) 

u 

CO 

•*■4 

4J 

c 

CO  o 

3 

Cd 

4H 

P 

o  • 

V-*' 

H  *0 

4J 

•o 

•H 

•H  V4 

•o 

>  4> 

*0  d> 

4)  4) 

d> 

d)  X 

d) 

O 

d> 

f— 1 

4-1 

o 

4)  bO 

P  ^ 

P  bO 

rH  M 

•r4 

CO 

d) 

C4 

i-<  e4 

♦r4 

c4  <4 

0) 

d)  M  d] 

c 

•  r— 4 

CL.  C3 

o 

N  *0 

p. 

4)  bO 

»  1 

?  bO 

o 

CO  4J  ^ 

o 

d)  p^ 

c 

*fH  d) 

CO 

Cd  E 

•rH 

f-»  P* 

iJ 

CO  ‘H 

o 

M  O 

(0  Cl 

U  O 

C«H 

CO  a  3 

u 

4->  :5 

P. 

• 

c 

o 

(0  P 

(0  P 

W  P 

u 

d)  _  C 

p 

•H  M 

3 

4J 

<u 

d)  p4 

4> 

4>  'r^ 

4) 

p 

bO  C 

•l^ 

u 

Cl 

0) 

rH  O- 

4) 

O  *3 

O  44 

O  TJ 

CO 

3  -P  3 

Cd 

M 

M 

P 

■o 

O  4) 

O  .W 

O  4) 

bO  f- 

o 

CO  4J 

0) 

««H  CO 

o 

Cl  U 

Cl  I-I 

P  O 

u 

p 

cn 

U 

Cd 

<a  "ci 

H 

o 

P.  C 

P.  (4 

P.  C 

d) 

O  O  <4- 

0) 

X  c 

C 

iJ 

4J  0) 

CO 

s 

4) 

3 

4> 

4J 

U  •H 

o 

<0  :3 

cd 

<d  iJ 

iJ 

O  P 

o  O' 

• 

O  P 

CO 

4J  0) 

•P 

•a  c 

•  •H 

<4  • 

4J  g) 

p 

p 

P  4> 

> 

fH  bO 

(U 

rH 

<d 

d>  C 

C4  0} 

4-1 

p 

44 

d>  CQ  cc 

OO  • 

rM 

C 

■o  » 

rH  p 

bO  O 

<0  « 

■o  • 

X 

•3  4) 

o 

'H  O  bO 

)-l  w 

1-t 

•H 

<4 

4J 

O  O 

C  Cl 

c  « 

3  P 

4J 

r4  Cu 

<d  >-i 

» 

^  4) 

•r4 

C4  f-l 

(4  o> 

3 

P.  c 

X  « 

•o 

Cl 

4J  • 

P.  Pu 

i  1 

c 

i  ■ 

•o 

P.  O  4- 

O  4J 

u 

0) 

C4  (4 

CO 

s 

§  3 

e 

3  P 

u  u 

4) 

V4 

O 

CO  U 

U  4-i 

O  C4 

O  M 

« 

O  P 

•o 

T 

H-l  (4 

M 

0) 

<4 

•rl  d) 

0)  o 

u  u 

O  « 

tp 

o  e 

•o 

a  bo  d) 

*d 

O 

4J 

bO  U 

X  u 

•o 

•w 

« 

1-1 

•tH 

a 

^  c  o 

<a 

c 

C  <4 

Cd  O 

fl  M 

*J  44 

P  P 

44 

P  44 

3  -4  c 

4 

«)  j: 

d> 

p 

-<  *0 

CO 

Cl  O 

U  -4 

U  CC 

O  14 

n 

*3  -o  3 

tiO  u 

d) 

3 

o 

n 

d)  ^ 

W  -H 

«  f-4 

« 

« 

«  i-t 

d) 

3  P  P 

c 

rH 

u 

M  "O 

a  CO 

«  Pu 

r-t  I4 

r-l  -O 

bO 

rP  3 

d 

0  0  3 

<d  eo 

•r4 

<d 

c 

(d 

•H  ^ 

>  o 

«  3 

a>  C 

14 

O  U  44 

od  •-< 

4-1 

> 

d) 

S  .o 

H  O 

o  u 

to  cy 

CO  i4 

bO 

a 

P  U  3 

> 

CU  3  P 

f— ^ 

p 

p 

i4 

i4 

c 

c 

4J 

3 

3 

>-✓ 

p 

cd 

> 

3 

u 

3 

3 

3 

«M 

s 

c 

se: 

c 

c 

c 

d> 

Ip 

o 

M 

o 

o 

o 

ol 

(fa 

c 

H 

c 

c 

c 

o 

o 


w 

« 

3 


m 


3 

W 

3 

> 

P 

P 

P 

3 

3 

3 

P 

-D 

1 

.P 

B 

3 

S 

P 

C 

c 

C 

d) 

d) 

3 

rH 

rH 

3 

3 

3 

3 

3 

M 

4J 

c 

bO 

bO 

bO 

•r4 

•M 

O 

3 

3 

3 

•o 

p 

x 

4J 

c 

bO 

bO 

bO 

3 

23 


H 

M 


Om 


£ 


O 

< 

o 

H 


o 

& 


o 

> 


I 


C-5 


(Continued) 
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This  qualifier  is  either  the  number  corresponding  to  the  order  in  which  the 
file  names  are  entered,  or  the  character  string  "ALL."  If  the  string  "ALL"  is 
used,  then  all  processing  procedures  selected  with  this  command  will  He 
performed  on  all  files. 

8.  Gage  numbers  are  listed  after  the  record  identifier  for  those  gages 
that  the  user  wishes  to  process.  If  the  gages  are  consecutive  in  value,  the 
user  can  list  the  first  and  last  gage  numbers,  separated  by  a  hyphen. 

9.  When  processing  more  than  one  file  simultaneously,  the  select 
commands  form  a  "plotting  matrix"  that  determines  the  contents  of  each  plot. 
One  plot  will  be  produced  for  each  column  in  the  matrix.  The  number  of  non¬ 
zero  entries  in  each  column  of  the  matrix  determine  the  number  of  lines  drawn 
on  each  plot.  The  nonzero  entries  are  the  gage  numbers  whose  time-histories 
are  to  be  plotted.  The  command  qualifiers,  which  define  the  matrix  rows, 
designate  the  file  containing  the  gage  data.  The  following  example 
illustrates  this  matrix  structure  for  files  AFILE,  BFILE,  CFILE,  and  DFILE: 


TGAGl  $ 
TGAG2  0 
TGAG3  0 
TGAG4  0 

Plot  1 


0 

J‘5 

4 

1-5 

2 

1-5 

0 

1-5 

Plot  2  Plots  3-7 


10.  A  total  of  seven  water  surface  elevation  plots  (or  tables)  will  be 
generated  from  the  four  files.  Command  qualifier  1  (in  command  TGAGl) 
corresponds  to  file  AFILE,  qualifier  2  corresponds  to  BFILE,  etc.  The  first 
plot  will  contain  the  time -history  of  gage  3  stored  in  file  AFILE.  (Zeros 
must  be  entered  for  null  gages.)  The  second  plot  will  contain  two  time- 
histories,  one  of  gage  A  in  file  BFILE  and  the  other  gage  2  in  CFILE.  The 
third  column  will  produce  five  plots.  The  third  plot  will  contain  the  time- 
histories  of  gage  1  from  each  of  the  four  files.  The  fourth  plot  will  contain 
time -histories  of  gage  2,  also  from  all  four  files,  and  so  forth,  with  the 
seventh  plot  being  time-histories  of  gage  5  from  all  four  files. 

Instruction  file  for  snapshot  programs 

11.  Instruction  file  requirements  for  the  snapshot  programs  are  similar 
to  those  required  by  the  time-history  programs: 

fl.  Each  command  in  the  file  must  begin  with  a  record  Identifier 
starting  in  column  1. 

li.  Format  and  select  commands  may  appear  in  any  order. 
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£.  Data  entered  after  the  record  identifier  are  read  free- 
format . 

12.  In  contrast  to  the  time-history  programs,  the  snapshot  programs  can 
process  only  one  file  at  a  time.  All  snapshot  instruction  file  commands  are 
described  in  Table  C-3.  Those  applicable  to  each  program  are  listed  in  the 
program  descriptions. 
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Program  HYDPLT 


13.  Program  HYDPLT  is  a  general  purpose  program  for  plotting  time- 
history  records  generated  and  stored  by  the  models  contained  in  CMS.  The  CMS 
models  save  the  following  information  for  each  gage  specified  by  a  RECGAGE 
record:  water  surface  fluctuation,  x  and/or  y  water  velocity  components,  and 
X  and  y  wind  velocity  components.  Atmospheric  pressures  are  saved  if  SPH  is 
used  to  generate  the  wind  fields.  Discharges,  saved  using  a  XRECRANG  or 
YRECRANG  record  when  running  the  models,  are  also  stored  in  this  file. 

14.  A  maximum  of  four  time-series  data  files,  where  each  data  file  can 
contain  up  to  120  gages,  may  be  processed  simultaneously.  No  gage  can  contain 
more  than  1,000  sampling  points. 

15.  An  Instruction  file  must  be  created  and  stored  before  execution  can 
begin.  Options  to  change  the  default  plotting  formats  are  Included  in  this 
file.  The  following  instruction  commands,  which  were  described  in  Table  C-2 
are  valid  for  this  program; 


DEBUG 

TGAG 

VGAG 

WGAG 

RGAG 

REPRT 

TSPL 

VSPL 

WSPL 

RSPL 

PFORM 

TAXIS 

VAXIS 

WAXIS 

RAXIS 

TITLE 

TIMES 

PENUP 

XAXIS 

NHCPY 

TTITL 

TADJ 

VTITL 

WTITL 

RTITL 

A  sample  instruction  file  for  program  HYDPLT  is  given  below: 


PFORM  4 

TITLE  CLHYD  SIMULATION  NO  1.  TIDE  WITHOUT  FEATHERING 
TAXIS  -5.  5.  2.5 
TGAGl  1-2 
DEBUG 


This  file  is  used  in  the  following  example. 

To  invoke  program  HYDPLT,  the  user  enters  the  command: 
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h2crplcl :  larry$ 

(It  should  be  noted  that  user  entries  are  shown  as  shaded,  and  CMS  response 
"screens"  are  shaded  boxes.)  The  CMS  responds: 


W  E 

L  C  0  M  E 

TO.. 

■ 

XXXXX 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X 

X  X 

X 

X 

X  J 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

XXXXX 

Return  for 

more . . . 

********************************************************************* 


*  CMS  COMPONENTS  * 

*  . . - . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  . >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . - . . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model . >  5  * 

*  * 

*  Exit  CMS  . - . >  q  * 


********************************************************************* 


To  use  the  CMSPOST  programs,  the  user  responds  to  the  CMS  prompt  with  a  value 
of  3: 

Enter  option  number  . >  3 


The  CMS  responds : 
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cccc 

M 

M 

SSSS 

ppppp 

00 

SSSS 

TTTTrTT 

c  c 

MM 

MM 

S  S 

p  p 

0 

0 

S  s 

T 

c 

M  M  M  M 

S 

p  p 

0 

0 

s 

T 

c 

M 

M  M 

SSSS 

ppppp 

0 

0 

SSSS 

T 

c 

M 

M 

S 

p 

0 

0 

s 

T 

c  c 

M 

M 

s  s 

p 

0 

0 

s  s 

T 

cccc 

M 

M 

SSSS 

p 

00 

SSSS 

T 

Return  for  more. . , 


************************************'*i(H:**'*****************T(lr*********Tilr 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

*******ic*ie********************1e*ic1rk****1rkirkic****i(ieie************-k***** 
*  * 

*  Options :  * 

*  * 

*  On-Line  Help  - >  1  * 

*  * 

*  Enter  CMSPOST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  - >  3  * 

*  * 


***ii!******************************irk*****iirk**irk**ie*****1rkirk-k*irk1rk**** 


Enter  option  number  . -->  '0. 

The  CMS  responds: 
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CMSPOST 

HYDPLT: 

Generates  plots  of  time  series  output 

HYDLST: 

Generates  lists  of  time  series  output 

HYDADD: 

Concatenates  two  successive  time  series 

SNAPVEC: 

Generates  vector  plots  of  model  output 

SNAPLST: 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT: 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT: 

Generate  profile  plots  of  model  output 

EXIT: 

Terminates  this  CMSPOST  session 

The  user  enters: 

The  CMS  responds: 


H  H 

Y  Y 

DDDDD 

PPPPP 

L 

TTTTTTT 

H  H 

Y  Y 

D  D 

P  P 

L 

T 

H  H 

Y  Y 

D  D 

P  P 

L 

T 

HHHHHH 

Y 

D  D 

PPPPP 

L 

T 

H  H 

Y 

D  D 

P 

L 

T 

#  H 

Y 

D  D 

P 

L 

T 

ii  H 

Y 

DDDDD 

P 

T4.T-T.TJ.T. 

T 

Ratum  for 

more .  .  . 

Enter  the  name  of  the  instruction  file: 

Valid  user  responses  are: 

TEK40  or  tek40  -  (hydrograph  file  will  be  plotted  on  TEKTRONIX 
4014  or  VT240  terminal) 

LASER  or  laser  -  (hydrograph  file  plotted  on  laser  printer) 
Enter  device  name 

How  many  input  data  files  will  be  processed?  ^ 

*4r«the  number  of  files  must  be  between  1  and  4 
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Do  you  want  to  reenter  the  number  of  files  to  be  processed? 

Enter  yes  or  no  to  continue 

Enter  the  nvunber  of  files  to  be  processed  % 

Enter  the  name  of  the  first  data  set: 

Enter  the  name  of  the  output  file: 

The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames. 
For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  simulation. 

The  CMS  submits  a  batch  Job  to  the  CRAY  Y-MP  and  the  system  responds: 

4359*  lurry 


CMSPOST 

HYDPLT: 

Generates  plots  of  time  series  output 

HYDLST: 

Generates  lists  of  time  series  output 

HYDADD: 

Concantenates  two  successive  time  series 

SNAPVEC: 

Generates  vector  plots  of  model  output 

SNAPLST: 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT: 

Generates  wave  ray  plots  of  RCH/AVE  output 

PROFPLT: 

Generate  profile  plots  of  model  output 

EXIT: 

Terminates  this  QiSPOST  sesSion 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component.  A 
DISSPLA*  metfll  is  thus  produced.  To  plot  the  HYDPLT  metfil  on  a  Tektronix  or 
Tektronix  emulator ,  the  user  types : 

/d^/hSerpleO/edutfiilot 

and  the  plot  is  displayed,  as  shown  below: 
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cunc  «R6  NOR  OVCMVC 

_  I  19  1C  ifurr  MC 


oinc  BK  HOI  viR  CWE  Wire 
_  2  15  OCOM  ense 


Figure  C-1.  Sample  water  surface  elevation  HYDPLT 


Similarly,  a  time-history  of  velocity  data  can  be  generated  using  the 
instruction  file  below: 


PFORM  4 

TITLE  CLHYD  SIMULATION  NO.  1:  TIDE  WITHOUT  FEATHERING 
VAXIS  6.0  2.0 
VGAGl  1-2 


Figure  C-2.  Sample  velocity  HYDPLT 


In  the  following  example, 
simulation  are  displayed. 


time -histories  of  wind  and  pressure  for  an  SPH 
The  instruction  file  for  this  plot  was  simply: 


WGAGl 

WAXIS  120  20  2.1 
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CU»VC  M  HOR  V9  ME  ME  OMC  M  HDR  VO  CRC  WTC 

_  3  IS  17  iwaH  IIAO  uwnai  - 3  is  I7  MSI  (SUH)  Locmiw 


T»C«  »OjRS  Stic,  KUa 


t««i  No.  i*  StOTM 


Figure  C-3.  Sample  wind  and  pressure  HYDPLT 
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Program  HYDLST 


16.  Program  HYDLST  is  a  general  purpose  program  for  printing  gage  time 
history  records  generated  and  stored  by  the  models  contained  in  CMS.  The  CMS 
models  save  the  following  information  for  each  gage  specified  by  a  RECGAGE 
record:  water  surface  elevations,  x  and/or  y  water  velocity  components,  and 
and  y  wind  velocity  components.  Atmospheric  pressures  are  saved  if  SPH  is 
used  to  generate  the  wind  fields.  Discharges,  saved  using  an  XRECRANG  or 
YRECRANG  record  when  running  the  models,  are  also  stored  in  this  file. 

17.  A  maximum  of  four  time-history  data  files  may  be  processed 
simultaneously  by  program  HYDLST,  with  each  data  file  containing  up  to  120 
gages.  No  gage  can  contain  more  than  1,000  sampling  points. 

18.  An  instruction  file  must  be  created  before  execution  can  begin. 
Options  to  change  the  default  formats  are  included  in  this  file.  The 
following  instruction  commands,  which  were  described  in  Table  C-2  are  valid 
for  this  program: 


TIMES 

TGAG_ 

TADJ_ 

VGAG_ 

WGAG_ 

RGAG 


A  sample  instruction  file  for  program  HYDLST  is  given  below; 


TGAGl  1-2 


********************************************************************** 
*  CMS  COMPONENTS  * 


*  Options :  * 

*  * 

CMSCRID  (Maps,  plots,  and  lists  the  numerical  grid)  - >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  . . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . - . >  4  * 

*  * 

*  Exit  CMS  . >  e  * 

********************************************************************* 
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cccc 

M 

M 

SSSS 

PPPPP 

00 

SSSS 

*r*ncT*rTT 

c 

MM 

MM 

S  S 

P  P 

0  0 

S  S 

T 

M  M  M  M 

S 

P  P 

0  0 

S 

T 

M  M 

M 

SSSS 

PPPPP 

0  0 

SSSS 

T 

M 

M 

S 

P 

0  0 

S 

T 

c 

M 

M 

S  S 

P 

0  0 

S  S 

T 

cccc 

M 

M 

SSSS 

P 

00 

SSSS 

T 

Return 

for  more. 

*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

************************************************************************** 
*  ★ 

*  Options :  •« 

*  * 

*  On-Line  Help  - - - - - - >  1  * 

*  * 

*  Enter  CMS POST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  - - - - - >  3  * 

*  * 


Enter  option  number  . >  2 

The  CMS  responds : 
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CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concantenates  two  successive  time  series  data 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  enters: 

The  CMS  responds: 


H  H 

Y  Y 

DDDDD 

L 

SSSSS 

TTTTTTT 

H  H 

Y  Y 

D  D 

L 

S 

T 

H  H 

Y  Y 

D  D 

L 

S 

T 

HHHHHH 

Y 

D  D 

L 

SSSS 

T 

H  H 

Y 

D  D 

L 

S 

T 

H  H 

Y 

D  D 

L 

S 

T 

H  H 

Y 

DDDDD 

LLLLLLL 

SSSSS 

T 

Return  for  more.  . 

• 

Enter  the  name  of  the  instruction  file:  fiydlSfei Ihi 

How  many  input  data  files  will  be  processed?  5 
***the  number  of  files  must  be  between  number  1  and  4*** 

Do  you  want  to  reenter  the  number  of  files  to  be  processed? 

Enter  yes  or  no  to  continue 

Enter  the  number  of  files  to  be  processed  1 

Enter  the  name  of  the  first  data  set:  ftydlstrl 

Enter  name  of  output  file 

The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames 
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For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  simulation. 


The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds; 


Request  4d43xlsrry  submlttsdl  to 


CMSPOST 

HYDPLT: 

Generates  plots  of  time  series  output  ^ 

HYDLST: 

Generates  lists  of  time  series  output 

HYDADD; 

Concantenates  two  successive  time  series 

SNAPVEC; 

Generates  vector  plots  of  model  output 

SNAPLST: 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT: 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT: 

Generate  profile  plots  of  model  output 

EXIT: 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component.  To  list 
the  HYDLST  results ,  the  user  types : 


pg  hydtst.ottt 


The  system  responds: 
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0.00 

0 . 86E+05 
360.000 
SECONDS 

ELEVATION  LISTING 


FILE  1  TITLE:  MOCK-UP  TEST 


FILE  1 

GAGE  1 

GAGE  2 

X  Y 

X  Y 

LOCATION 

3  13 

11  13 

TIME 

ELEVATION 

ELEVATION 

SECONDS 

FEET 

FEET 

0.00 

0.500 

0.570 

360.00 

0.500 

0.570 

720.00 

0.500 

0.570 

10440.00 

0.500 

0.570 

10800.00 

0.613 

0.570 

11160.00 

0.900 

0.570 

11520.00 

1.11 

0.570 

11880.00 

1.35 

0.629 

12240.00 

1.49 

0.687 

12600.00 

1.62 

0.685 

12960.00 

1.80 

0.724 

13320.00 

2.02 

0.771 

13680.00 

2.20 

0.799 

14040.00 

2.30 

1.03 

14400.00 

2.42 

1.26 

14760.00 

2.58 

1.48 

15120.00 

2.67 

1.72 

15480.00 

2.86 

1.97 

15840.00 

3.09 

2.22 

16200.00 

3.16 

2.47 

16560.00 

3.17 

2.74 

FILE  1 
FILE  TITLE 
MOCK-UP  TEST 

PROVISIONAL  STARTING  TIME: 
PROVISIONAL  ENDING  TIME: 
DATA  INTERVAL: 

TIME  UNIT: 
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Program  HYDADD 


20.  Program  HYDADD  concatenates  two  time-history  data  files  from 
successive  simulations  of  the  long-wave  models.  Program  HYDADD  is  typically 
applied  to  a  WIFM  "cold  start"  hydrofile  and  a  WIFM  "hot  start"  hydrofile  to 
make  one  combined  hydrofile.  No  instruction  file  is  required.  However,  the 
following  requirements  must  be  met: 

a.  The  two  files  must  be  sequential  in  time. 

b.  All  gages  and  ranges  must  be  identical,  in  nxamber  and  sequence, 
in  the  two  files. 

c.  Grid  rotation  must  be  identical  in  the  two  files. 

The  program  will  check  the  above  requirements  and  will  terminate  with  an 
appropriate  error  message  if  any  violations  are  detected. 

21.  To  invoke  program  HYDADD,  the  user  enters  the  command: 

h2crplcl:larry$ 


The  CMS  responds: 


WELCOME 

TO.. 

• 

XXXXX  X 

X 

XXXXX 

XX  XX 

XX 

X  X 

X  X  X  X  X 

X 

X  XX 

X 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

X 

XXXXX 

Return  for 

more . . . 
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A******************************************************************** 


*  CMS  COMPONENTS  * 

. . . . . . . * 

*  Options:  * 

-*  * 

*  CHSGRID  (Maps,  plots,  and  lists  the  ntunerlcal  grid)  . . >  1* 

*  :  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - - - >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model  - >  5  * 

*  * 

*  Exit  CMS  . . . . . . . >  q* 


****ilHr*************************************************************** 


Enter  option  number 


>  I 


The  CMS  responds: 


CCCC 

M 

M 

SSSS 

PPPPP 

00 

SSSS 

TTTTTTT 

C  C 

HH 

MM 

S  s 

P  P 

0  0 

S  S 

T 

c 

M  M  M  H 

s 

P  P 

0  0 

s 

T 

c 

M  M 

M 

ssss 

PPPPP 

0  0 

SSSS 

T 

c 

H 

M 

s 

P 

0  0 

s 

T 

c  c 

H 

M 

s  s 

P 

0  0 

s  s 

T 

CCCC 

M 

H 

ssss 

P 

00 

ssss 

T 

Return 

for  more. 

i 

I 
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**************************************  ■**'>Hr*'********'************'il'*^Hr****** 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

**********ie************-kie**ie***********ic****-k*irk***-ir)rk*-kitii**'iL"k  *  H***  *  * 
*  * 

*  Options:  * 

*  ♦ 

*  On-Line  Help  . - . . . l  * 

*  * 

*  Enter  CMSPOST  Module  . - . . . ->  2  * 

*  ■* 

*  Return  to  Main  Menu  - - - 3  * 

*  * 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  enters : 

The  CMS  responds : 
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H 

H 

Y  Y 

DDDDD 

AA 

DDDDD 

DDDDD 

H 

H 

Y  Y 

D 

D 

A 

A 

D  D 

D  D 

H 

H 

Y  Y 

D 

D 

A 

A 

D  D 

D  D 

HHHHHH 

Y 

D 

D 

AAAAAA 

0  D 

D  D 

H 

H 

Y 

D 

D 

A 

A 

D  D 

D  D 

H 

H 

Y 

0 

D 

A 

A 

D  D 

D  D 

H 

H 

Y 

DDDDD 

A 

A 

DDDDD 

DDDDD 

Return  for 

more .  . 

- 

Enter 

the 

name 

of 

Enter 

the 

name 

of 

Enter 

the 

name 

of 

the  first  data  set: 

the  second  data  set: 

combined  data  set:  fllecom»hyd 


The  user  can  choose  any  meaningful  naming  convention  when  selecting  filenames. 
For  example,  the  user  may  choose  a  project  name  with  different  extensions  for 
each  file. 


The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 
4243  tfttbmitted  fco  4|tteue;|>riBt« 


The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component. 
The  individual  files  and  combined  files  are  as  follows: 


MOCK-UP  TEST 

a 

O.OOOE+00  1  1 

1  0 

0 

SECtWDS  FEET 

FPS 

FPS 

FEETH20  CFS 

0.00 

360.00  720.00 

1080.00 

1440.00 

1800.00 

2160.00 

2520.00 

2880.00 

3240.00  3600.00 

TOAGE  1 

3  13GAGE  1 

2  138 

O.SOO 

O.SOO  0 . SOO 

O.SOO 

0.500 

O.SOO 

0.500 

0.500 

O.SOO 

O.SOO  O.SOO 

VGAGE  1 

3  13GAGE  1 

2  138 

-0.120 

-0.4S4  -0.218 

-0.237 

-0.277 

-0.276 

-0.230 

-0.113 

-0.131 

-0.184  -0.086 
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8  0 

3600.00 

MOCK-UP  TEST 

.OOOE-fOO  1110 

SECONDS  FEET  FPS 

3960.00  4320.00  4680.00 

0 

FPS 

5040.00 

feetbeo  CFS 

5400.00  5760.00 

6120.00 

TGAGE  1 

Ol.SOO 

3  13GAGE  1  2  13$ 

Ol.SOO  Ol.SOO  01. 

.500 

Ol.SOO 

Ol.SOO 

01.500 

01.500 

VGAGE  1 

-1.120 

3  13GAGE  1  2  13$ 

-1.454  -1,218  -1.237 

-1.277 

-1.276 

-1.230 

-1.113 

MOCK-UP  TEST 

18  0 

000  1  1 

1  0 

0 

SEC(»IDS  FEET 

FPS 

F 

0.00 

360.00  720.00 

1080.00 

1440.00 

1800.00 

2160.00 

2520.00 

2880.00 

3240.00  3600.00 

3960.00 

4320.00 

4680.00 

5040.00 

5400.00 

5760.00 

6120.00 

TGAGE  1 

3  13GAGE  1 

2  13$ 

0.500 

0.500  0.500 

0.500 

0.500 

0.500 

0.500 

0.500 

0.500 

0.500  1.500 

1.500 

1.500 

1.500 

1.500 

1.500 

1.500 

1.500 

V6AGE  1 

3  13GAGE  1 

2  13$ 
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Program  SNAPVEC 


22.  Program  SNAPVEC  produces  vector  plots  of  water  and  wind  velocities. 
A  maximum  of  100  snapshots  can  be  stored  in  the  data  file.  An  instruction 
file  must  be  created  before  execution  can  begin.  Options  to  change  the 
default  plotting  formats  are  included  in  this  file.  The  following  instruction 
commands,  which  are  described  in  Table  C-3,  are  valid  for  this  program: 


DEBUG 

VWINDO 

WWINDO 

NOAVE 

VSCALE 

WSCALE 

TIMES 

TWINDO 

PWINDO 

TITLE 

GAGLOC 

A  sample  instruction  file  for  program  SNAPVEC  is  given  below: 


TIMES  LAST 
WWINDOl  1  26  1  24 
WSCALEl  60.0  0.5 


23.  To  invoke  program  SNAPVEC,  the  user  enters  the  command: 


h2crplcl : larry$  /u3/h2crplc0/cms 


The  CMS  responds: 
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WELCOME  TO.. 


xxxxx 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  3 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

3 

X  X 

X 

X 

X  3 

XXXXX 

X 

X 

XXXXX 

Return  for 

more. . , 

***********************•>(********************************************* 


*  CMS  COMPONENTS  * 

*  . . . . . . . . 

*  Options:  * 

*  ,*■ 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  1  * 

*  '*• 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  — - - 2  * 

*  ■  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - - ->3  * 

* 

*  CMSUTIL  (Additional  "utility"  programs)  — . 4  * 

*  ,  -  ‘  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model  ----->  ^  * 

*  ■'  It 

*  Exit  CMS  . . . ----> - ... . . . . >  q  * 


Enter  option  number  . . . . >  | 

The  CMS  responds : 
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T 

Return 

for  more . 

************************'JHt**'******Tllr'****************'*****'************* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options :  * 

*  * 

*  On-Line  Help  . >  1  * 

*  * 

*  Enter  CMS POST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . >  3  * 

*  * 


********************************************************************* 


Enter  option  number 
The  CMS  responds: 


C-34 


CMSPOST 


HYDPLT:  Generates  plots  of  time  series  output 
HYDLST:  Generates  lists  of  time  series  output 
HYDADD:  Concantenates  two  successive  time  series 

SNAPVEC:  Generates  vector  plots  of  model  output 
SNAPLST:  Generates  lists  of  field  arrays  described 
in  SNAPVEC 

RAYPLT;  Generates  wave  ray  plots  of  RCPWAVE  output 
PROFPLT:  Generate  profile  plots  of  model  output 
EXIT;  Terminates  this  CMSPOST  session 


The  user  enters : 

The  system  responds: 


Enter  the  name  of  the  instruction  file; 

Valid  user  responses  are: 

TEK40  or  tek40  -  hydrograph  file  will  be  plotted  on  TEKTRONIX  4014 
or  VT240  terminal 

LASER  or  laser  -  if  you  want  laser  output  here  at  CERC 
Enter  device  name 

Enter  name  of  input  file  containing  snapshots  data  that  were  generated  by 
WIFM,  CLHYD,  SPH,  or  other  model 


sssss 
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N  N 

A  A 

P 

\ 

V 

E 

C 

s 

N 

NN 

A  A 

P 

V  V 

E 

C 

sssss 

N 

N 

A  A 

P 

V 

EEEEEE 

CCCC 

Return 

for  more. 

• 

• 
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Enter  name  of  output  data  set 


The  system  responds: 


STOP 

CP:0.002s,  Wallclock: 0.038s,  0.8%  of  6-CPU  Machine 
Request  4362.1arry  submitted  to  queue: prime 


The  CMS  responds : 


CMSPOST 

HYDPLT: 

Generates  plots  of  time  series  output 

HYDLST: 

Generates  lists  of  time  series  output 

HYDADD: 

Concatenates  two  successive  time  series 

SNAPVEC: 

Generates  vector  plots  of  model  output 

SNAPLST: 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT: 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT: 

Generate  profile  plots  of  model  output 

EXIT: 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component. 

To  plot  the  SNAPVEC  file  on  the  laser  printer,  the  user  transfers  the  file  to 
the  VAX  3300  using  the  ftp  command  (see  Chapter  2)  and  types: 

«td00001.det: 

A  typical  SNAPVEC  plot  is  shown  below: 
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LENGTH!  60.00  KNOTS 


Figure  C-4.  Sample  wind  velocity  (SNAPVEC)  plot 
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Program  SNAPLST 

24.  Program  SNAPLST  produces  printouts  of  field  array  variables.  The: 
variables  are  total  water  depth,  water  surface  elevation,  water  velocities, 
wind  velocities,  and  atmospheric  pressure.  Water  and  wind  velocities  may  be 
printed  as  x  and  y  components,  or  as  magnitude  and  direction.  Atmospheric 
pressures  are  printed  if  SPH  is  used,  either  as  a  stand-alone  model  or  as  a 
component  of  WIFM,  to  generate  the  wind  fields.  A  maximum  of  100  snapshots 
can  be  stored  in  the  data  file. 

25.  An  instruction  file  must  be  created  before  execution  can  begin. 
Options  to  change  the  default  printing  formats  are  included  in  this  file.  T1 
following  instructions  commands,  which  are  described  in  Table  C-3,  are  valid 
for  this  program: 


DEBUG 

TSAMPL 

VSAMPL 

WSAMPL 

PSAMPL 

TIMES 

TFORMT 

VFORMT 

WFORMT 

PFORMT 

VPOLAR 

WP0LAR_ 

A  sample  instruction  file  for  program  SNAPLST  is  given  below: 


TIMES  1 
TFORMTl  1514 
TSAMPLl  1  1 


26.  To  invoke  program  SNAPLST,  the  user  enters  the  command: 


h2crplcl : larry$  /tt3/h2crplc0/cms 


The  CMS  responds : 


WELCOME 

TO.. 

• 

XXXXX  X 

X 

XXXXX 

XX  XX 

XX 

X  X 

X  X  X  X  X 

X 

X  XX 

X 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

Return  for 

X 

more. . . 

XXXXX 

***********^r*************1)Hlr**»**»*^HIr****■jH^***^»^;^^»'llHI^■**^^■»*****^^*♦*'*<r^r**^» 


*  CMS  COMPOl'f^lTS  * 

*  . .  . . . * 

*  Options ;  * 

*  * 

*  CMSGRID  (Maps ,  plots ,  and  lists  the  ntunerical  grid)  - - >  1* 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - 2  * 

if 

*  CMSPOST  (Plots  and  lists  model  outputs)  - -•->  3  * 

*  it 

*  CMSUTIL  (Additional  "utility"  programs)  - >  A  * 

it  ★ 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model  - >  5  * 

*  * 

*  Exit  CMS  . >  q  * 


Enter  option  number  . . >  | 

The  CMS  responds: 
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The  user  enters  ; 


The  system  responds: 
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A 

P 
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SSSSS 

TTTTrrr 


Return  for  more.  .  , 


Enter  the  name  of  the 
Enter  the  name  of  the 
Enter  the  name  of  the 
The  system  responds: 


instruction  file: 
input  data  set: 
output  data  set 


STOP 

CP:002s,  Wallclock:0:105s,  0.3%  of  6 -CPU  Machine 
Request  4343.1arry  submitted  to  queue :prime 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 
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H  H  H  H  H  H 


The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component. 
To  display  the  output  file,  the  user  enters: 

pg  inaplst.out 


and  the  system  responds: 


MOCK  UP  TEST 

SURFACE  ELEVATIONS 

(FEET 

) 

SNAPSHOT  TIME 

mm 

Ihrs  OMIN 

OSEC 

X-  1 

2 

3 

4 

5 

4  7.13 

7.25 

7.22 

7.29 

7.44 

3  7.13 

7.21 

7.20 

7.29 

7.48 

2  7.13 

7.16 

7.09 

7.13 

7.24 

1  7.13 

7.13 

7.13 

7.13 

7.13 

C-A2 


27.  Program  RAYPLT  is  a  wave  ray  plotting  program  specific  to  model 
RCPWAVE  output  only.  RCPWAVE  saves  wave  angle  data  for  each  grid  cell  if  a 
PLOTREC  record  is  contained  in  the  RCPWAVE  input  file .  The  wave  angle 
information  is  used  to  generate  a  wave  ray  plot  for  each  wave  condition 
simulated  by  RCPWAVE. 

28.  An  instruction  file  must  be  created  and  stored  before  execution  can 
begin.  Options  to  change  the  default  plotting  formats  are  included  in  this 
file.  The  following  instruction  commands,  which  are  described  in  Table  C-4, 
are  valid  for  this  program: 

TITLE 
ROTAN 
COAST 
DUNIT 
XYINC 


29.  To  invoke  program  RAYPLT,  the  user  enters  the  command: 


h2crplcl:larry$  /u3/h2CTl»lcO/Cfll« 
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nstruction  File  Commands  for  Wave 
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The  CMS  responds : 


WELCOME 

TO.. 

• 

XXXXX  X 

X 

XXXXX 

XX  XX 

XX 

X  X 

X  XX 

X  X 

X 

X  XXX 

XXXXX 

X  X 

X 

X 

XX  X 

X 

X  X 

XXXXX  X 

Return  for 

X 

more . . . 

XXXXX 

*  CMS  COMPONENTS  * 

*  . . . ■* 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  - - >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models)  - - - - >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  - >  3  * 

*  * 

*  CMSUTIL  (Additional  "utility"  programs)  . >  4  * 

*  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model  - >  5  * 

*  * 

*  Exit  CMS  - >  q  * 


Enter  option  number  . . . >  S 

The  CMS  responds : 
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Return  for  more. . . 


********************************************************************* 


*  * 

*  USING  THE  COASTAL  MODELING  SYSTEM  * 

*  * 

********************************************************************* 
*  * 

*  Options :  * 

*  * 

*  On-Line  Help  . >  1  * 

*  * 

*  Enter  CMSPOST  Module  . >  2  * 

*  * 

*  Return  to  Main  Menu  . >  3  * 

*  * 


********************************************************************* 


Enter  option  number  . . >  % 


The  CMS  responds: 
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CMSPOST 


HYDPLT 

HYDLST 

HYDADD 

SNAPVEC 

SNAPLST 

RAYPLT 

PROFPLT 

EXIT 


Generates  lists  of  time  sereis  output 
Generates  lists  of  time  series  output 
Concatenates  two  successive  time  series 
Generates  vector  plots  of  model  output 
Generates  lists  of  field  arrays  described 
in  SNAPVEC 

Generates  wave  ray  plots  of  RCPWAVE  output 
Generate  profile  plots  of  model  output 
Terminates  this  CMSPOST  session 


The  user  enters:  iHHii 
The  system  responds : 


RRRRR 
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LLLLLL 
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Return  for 

more .  .  . 

Enter  the  name  of  the  instruction  file:  feyptfc ^ ins 
Enter  the  name  of  the  shoreline  file:  rsyplfc.shl 
Enter  the  name  of  the  wave  angle  file: 

Valid  user  responses  are: 

TEK40  or  tek40  -  (hydrograph  file  will  be  plotted  on  TEKTRONIX 
4014  or  VT240  terminal) 

LASER  or  laser  -  (hydrograph  file  plotted  on  laser  printer) 
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Enter  device  name 

Enter  name  of  output  data  file:  sr^ypXt^out: 

The  CMS  submits  a  batch  job  to  the  CRAY  Y-MP  and  the  system  responds: 

STOP 

CP:002s,  Wallclock: 0:105s,  0.3%  of  6-CPU  Machine 
Request  4343.1arry  submitted  to  queue: prime 


CMSPOST 

HYDPLT 

Generates  plots  of  time  series  output 

HYDLST 

Generates  lists  of  time  series  output 

HYDADD 

Concatenates  two  successive  time  series 

SNAPVEC 

Generates  vector  plots  of  model  output 

SNAPLST 

Generates  lists  of  field  arrays  described 

in  SNAPVEC 

RAYPLT 

Generates  wave  ray  plots  of  RCPWAVE  output 

PROFPLT 

Generate  profile  plots  of  model  output 

EXIT 

Terminates  this  CMSPOST  session 

The  user  types  'exit'  or  'EXIT'  to  terminate  the  CMSPOST  component.  To  plot 
the  RAYPLT  metfil  on  a  Tektronix  or  Tektronix  emulator,  the  user  types: 


/u3/h2crplc0/cmsplot 


and  the  plots  are 


displayed, 


as  shown  below: 
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Program  PROFPLT 

30.  Program  PROFPLT  is  a  general  purpose  program  for  generating  profile 
plots  of  data  produced  by  the  models  in  CMS.  Field  arrays,  such  as 
bathymetry,  water  surface  level,  wave  height,  magnitude  of  water  velocity,  and 
magnitude  of  wind  velocity,  can  be:  (a)  saved  by  the  models  (using  RECSNAPS) , 
or  (b)  read  directly  from  the  model  input  file  (i.e.,  BATHSPEC)  for  use  by 
PROFPLT.  A  one -dimensional  "line"  from  the  array  is  plotted  in  profile  form 
to  show  the  distribution  of  the  variable  along  the  selected  "transect."  For 
example,  if  a  mound  exists  in  a  given  study  area,  one  could  select  a  transect 
through  the  mound,  and  plot  the  bathymetry  and  wave  height  over  the  mound. 

31.  A  maximum  of  100  profiles  can  be  processed  during  one  PROFPLT 
session.  An  instruction  file  must  be  created  before  execution  can  begin. 
Options  to  change  the  default  plotting  formats  are  included  in  this  file.  The 
following  instruction  commands,  which  are  decribed  in  Table  C-5,  are  valid  for 
this  program: 


DEBUG 

TITLE 

YAXIS 

TRANS 

LINE_ 

BATHY 

CURV2 

TIMES 


A  sample  instruction  file  for  program  PROFPLT  is  given  below: 


TRANS  1 

LINEl  1  20  27  27 
BATHY 

YAXIS  DEPTH,  meters 
DEBUG 

TITLE  PROFPLT  EXAMPLE 
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Instruction  File  Commands  for  Wave  Rav  Plots 
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PROFPLT  EXRMPLE 

X  Direction  Profile  frotn  Cells  1  to  20  RLONG  Y 
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Introduction 


1.  CMSSAMP  is  a  component  of  the  Coastal  Modeling  System  (CMS)  that 
contains  sample  input  and  output  files  for  each  of  the  models  in  the  CMS  for 
users  to  view  or  copy  to  their  own  computer  accounts.  This  feature  allows  the 
user  to  examine  the  general  input  requirements  and  data  formats  or  actually 
run  a  model  to  get  a  "feel"  for  typical  input/output  data  set  structures, 
model  responses,  and  model  execution  times.  Table  D-1  contains  the  names  and 
a  brief  description  of  the  sample  input  and  output  files  contained  in  CMSSAMP 
for  each  of  the  CMS  models.  These  files  are  also  used  for  the  examples 
documented  in  the  individual  model  chapters . 

2.  For  illustrative  purposes,  the  input  and  output  files  for  model  WIFM 
will  be  displayed  with  the  CMS  menus  in  the  following  paragraphs.  To  invoke 
the  CMS,  the  user  enters  the  command; 


h2crplcl : larry$  /u3/h2crplc0/cas 


(It  should  be  noted  that  user  entries  are  shown  as  shaded, 
"screens"  are  shaded  boxes.)  The  CMS  responds: 


and  CMS 


response 


W  E 

L  C  0  M  E 

T  0  . 

•  • 

XXXXX 

X 

X 

XXXXX 

X  X 

XX 

XX 

X  X 

X 

X  X  X  X 

X 

X 

X  X 

X 

XXXXX 

X 

X 

X 

X 

X  X 

X 

X 

X  X 

XXXXX 

X 

X 

XXXXX 

Return  for 

more .  .  . 
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Table  D-1 

CMSSAMP  Input  and  Output  File 


Input  File  Output  File 

Model _ Name _ Description _ Name _ Description 

SPH  SPH_EX1.INP  SPH  Storm  SPH_EX1.0UT  General  output 

SPH_EX1 . SNP  Snapshot  data 
SPH_EX1 . HYD  Hydrograph  data 

SPH_EX2 . INP  Hindcast  Storm  SPH_EX2.0UT  General  output 

SPH_EX2 . SNP  Snapshot  data 
SPH_EX2.HYD  Hydrograph  data 

WIFM  WIFM_EX1.INP  Tide  without  feathering  WIFM_EX1.0UT  General  output 

WIFM_EX1.HYD  Hydrograph  data 

WIFM_EX2 . INP  Tide  +  nonlinear  terms  WIFM_EX2.0UT  General  output 

WIFM_EX2.HYD  Hydrograph  data 

WIFM_EX3.INP  Tide  with  wind  WIFM_EX3.0UT  General  output 

WIFM_EX3.HYD  Hydrograph  data 

WIFM_EX4.INP  Tide  +  river  discharge  WIFM_EX4.0UT  General  output 

WIFM_EX4.HYD  Hydrograph  data 

WIFM_EX5.INP  Storm  surge  example  WIFM_EX5.0UT  General  output 

WIFM_EX5.HYD  Hydrograph  data 

RCPWAVE  RCPEXl.INP  Duck,  NC  example  RCP_EX1.0UT  General  output 

RCP_EX1.SHL  Shoreline  data 

RCP_EX1.ANG  Wave  angle  data 

RCP_EX2.INP  Homer  Spit,  AK  example  RCP_EX2.0UT  General  output 

RCP_EX2.SHL  Shoreline  data 

RCP_EX2.ANG  Wave  angle  data 

CLHYD  CLHYD_EX1 . INP  Tide  without  feathering  CLHYD_EX1 . OUT  General  output 

CLHYD_EX1.HYD  Hydrograph  data 

CLHYD_EX2 . INP  Tide  +  nonlinear  terms  CLHYD_EX2 . OUT  General  output 

CLHYD_EX2 . HYD  Hydrograph  data 

CLHYD_EX3 . INP  Tide  with  wind  CLHYD_EX3 . OUT  General  output 

CliIYD_EX3 . HYD  Hydrograph  data 

CLHYD_EX4 . INP  Tide  +  river  discharge  CLHYD_EX4 . OUT  General  output 

CLHYD_EX4 . HYD  Hydrograph  data 

CLHYD_EX5 . INP  Storm  surge  example  CIiryD_EX5 . OUT  General  output 

CIifYD_EX5 . HYD  Hydrograph  data 

SHALWV  FILEIM.SWV  Parameter  file  MOUND. MTX  Wave  field 

or  DEPMOUND.SWV  Bathymetry  file  MOUND. SPE  Wave  spectra 

STWAVE  BOUNDIN.SWV  Boundary  condition  file  MOUND. SEA  Wave  charact¬ 

eristics 


STWAVEIN.SWV  General  input  file  FILENMM.SWV  Post-processing 

FILENMIM.SWV  Main  file  name  file  BOUNDOTM.SWV  Binary  boundary 

conditions 

HARBD  AGAT.INP  Agat  Harbor,  Guam  AGAT.OUT  General  output 

MAAL.INP  Maaleaa  Habor,  Hawaii  MAAL.OUT  General  output 
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************************************************************************** 


*  CMS  COMPONENTS  * 

*  . - . - . . . . . * 

*  Options :  * 

*  * 

*  CMSGRID  (Maps,  plots,  and  lists  the  numerical  grid)  - >  1  * 

*  * 

*  CMSMODEL  (Compiles,  links,  loads,  and  executes  * 

*  numerical  models  . . - . >  2  * 

*  * 

*  CMSPOST  (Plots  and  lists  model  outputs)  . >  3  * 

*  ★ 

*  CMSUTIL  (Additional  "utility"  programs)  . - . . >  h  * 

*  * 

*  CMSSAMP  (Sample  input  and  output  files  for  each  model . >  5  * 

*  * 

*  Exit  CMS  . >  q  * 


********************************************************************* 


To  display  the  CMSSAMP  menu,  the  user  responds  to  the  CMS  prompt  with  a  value 
of  5: 

Enter  option  number  . . . >  1 

The  CMS  responds : 


cccc 

M 

M 

ssss 

ssss 

AA 

MM 

MM 

PPPPPP 

;  c 

MM 

MM 

s  s 

s  s 

A 

A 

M  M  M  M 
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Return  for  more. . . 
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To  view  the  sample  input  and  output  files  for  model  WIFM,  the  user  responds  to 
the  CMS  prompt  with  a  value  of  2: 


Enter  option  number 


The  CMS  responds : 


W 
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I 
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Return 

for  more. 

****************************  ****'Ar*'********'*****-**')l:-)irx*******'************* 

* 

* 

*  Sample 

Input  and  Output 

Files  Available  for  WIFM:  * 

★ 

* 

itific'kie-^‘kiticicicicic9:'k'kicicieicicicicic'kicicic'kic‘k'kitiic-kic-kic'k'k'k'k'k'k'k'k‘k^'k'k'k‘k‘k'k'k'k'k'kicic'kic'k'k'ki(ic'k’k 

* 

■* 

*  Input  Files 

* 

★ 

* 

* 

WIFM  EXl.INP 

* 

* 

WIFM  EX2.INP 

* 

* 

WIFM  EX3.INP 

* 

* 

WIFM  EX4.INP 

* 

* 

WIFM  EX5.INP 

* 

* 

★ 

* 

* 

*  Output  Files: 

* 

* 

* 

* 

WIFM  EXl.OUT 

WIFM  EXl.HYD  * 

* 

WIFM  EX2.0UT 

WIFM  EX2 . HYD  * 

* 

WIFM  EX3.0UT 

WIFM  EX3.HYD  * 

* 

WIFM  EX4.0UT 

WIFM  EX4 . HYD  * 

* 

WIFM  EX5.0UT 

WIFM  EX5.HYD  * 

* 

* 

To  select  a  sample  input  or  output  file  from  the  list  above,  the  user  types 
the  file  name  at  the  CMS  prompt: 


Enter  file  name  (or  'exit'  to  return  to  previous  menu)  . >  wifm_exlii  inp 

To  display  a  portion  of  the  contents  of  the  selected  file,  the  user  types  'y' 
at  the  CMS  prompt: 


Display  file?  (  (y)es  or  (n)o  )  . > 

The  CMS  responds: 


***  NOTE  *** 

To  terminate  the  screen  display  type  'q'  at  the  prompt 
Press  'RETURN'  to  display  the  selected  file 
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GENSPECS 

WIFM 

SIMULATION  NO.  1: 

TIDE  WITHOUT  FEATHERING 

ENGLISH 

TIMESPEC 

30, 

SECONDS 

0. 

86400. 

360. 

GRIDSPEC 

ENGLISH 

75 

30 

500. 

1000.  0 

0. 

PRWINDOW 

3600. 

EV 

RECGAGE 

19 

16 

INLET  GAGE 

RECGAGE 

42 

15 

OCEAN  GAGE 

XBOUNDRYCONSTELV 

75 

1 

30 

1 

BRDYX 

YBOUNDRYINTRPELV 

1 

17 

75 

9 

1  BRDYl 

YBOUNDRYINTRPELV 

30 

17 

75 

2 

1  BRDY2 

FUNCTION 

IHARNCNST 

CNRECORD 

0.0 

1981 

6 

1 

2.5 

CONSTIT 

M2 

3.97 

199.02 

FUNCTION 

2HARNCNST 

CNRECORD 

0.0 

1981 

6 

1  2 

.6667 

CONSTIT 

M2 

3.97 

199.02 

XBARRIER 

17 

14 

14 

2.5 

XBl 

XBARRIER 

19 

15 

15 

2.5 

XB2 

XBARRIER 

21 

16 

16 

2.5 

XB3 

XBARRIER 

18 

17 

17 

2.5 

XB4 

:<|  terminates  the  screen  display  of  the  selected  file.  To  copy  the  selected 
file  to  the  user's  account,  the  user  types  'y'  at  the  CMS  prompt: 

Copy  the  file  to  your  account?  (  (y)es  or  (n)o  )  . > 


Enter  the  destination  file  name  (the  file  name  on  your  account,  including  the 
path)  . >  /u3/h2crplcl/myfiles/exl.lnp 

Any  of  the  sample  files  can  be  displayed  or  copied  to  the  user's  account  in 
this  manner.  As  additional  models  are  added  to  the  CMS,  sample  input  and 
output  files  for  those  models  will  be  added  to  CMSSAMP. 
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